Provision API Key

Generate a secret key from the API Keys page. Active Pro, Unit, or Enterprise plan required.

Header

x-api-key: orca_live_8X_hBwW2...

Execute Analysis

POST an image URL. The depth parameter controls reasoning intensity.

cURL

curl -X POST https://oceanir.ai/api/v1/geolocate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "depth": 2
  }'

Tip · image_url vs image_b64

If the image is hosted on a service that blocks non-browser User-Agents (Wikipedia, some asset CDNs, certain S3 bucket policies), the image_url fetch can fail with HTTP 400 or 403. In that case, fetch the image yourself and pass it as a base64-encoded JPEG via image_b64. Max payload size is 20 MB.

depth: 1classification

~4s

depth: 2analysis

~8s

depth: 3investigation

~14s

Read Response

Structured coordinates, address, confidence, and the reasoning chain.

Response

{
  "success": true,
  "location": {
    "latitude": 25.73003,
    "longitude": -80.32348,
    "address": "NW 97th Ave, Doral, FL 33178"
  },
  "confidence": 0.79,
  "reasoning": "Wide arterial road, royal palms, Marathon gas station...",
  "model": "orca-2.1",
  "depth": 2
}

locationobjectLatitude, longitude, and reverse-geocoded address

confidencefloatModel certainty from 0 to 1

reasoningstringVisual evidence chain used to reach the conclusion

Live

Try it — drop a photo, get coordinates. No key needed.

Orca Capabilities

Benchmarks, evidence flow, operator features

Key Management

Rotate keys, assign descriptions, monitor usage