Provision API Key

Generate a secret key from the API Keys page. Active Pro, Developer, or Teams 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 "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "depth": 2
  }'

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...",
  "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