Oceanic AI — API Reference

{
  "response": "GDPR (General Data Protection Regulation) is...",
  "tokens": 847,
  "session_id": "my-app-session-001",
  "credits_used": 2
}

response = requests.post(f"{BASE_URL}/chat", headers=headers, json={
    "message": "What are the GDPR data retention rules?",
    "agent": "legal",
    "session_id": "contract-review-001"
})
print(response.json()["response"])

curl -X POST "https://app.oceanicco.nl/api/v1/chat" \
  -H "Authorization: Bearer sk_live_ocean_..." \
  -H "Content-Type: application/json" \
  -d '{"message":"What are GDPR data retention rules?","agent":"legal","session_id":"s1"}'

# Python — multipart upload
with open("contract.pdf", "rb") as f:
    response = requests.post(
        f"{BASE_URL}/rag/upload",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"file": ("contract.pdf", f, "application/pdf")}
    )
doc_id = response.json()["doc_id"]

response = requests.post(f"{BASE_URL}/rag/query", headers=headers, json={
    "query": "What are the payment terms in the contract?",
    "doc_ids": [doc_id]  # optional
})
print(response.json()["answer"])

docs = requests.get(f"{BASE_URL}/rag/docs", headers=headers).json()
for doc in docs["documents"]:
    print(doc["filename"], doc["doc_id"])

response = requests.post(f"{BASE_URL}/studio/process", headers=headers, json={
    "text": "Hallo, hoe gaat het met jou?",
    "source_lang": "nl",
    "target_lang": "en",
    "mode": "translate"
})
print(response.json()["result"])
# → "Hello, how are you?"

# Start research job
job = requests.post(f"{BASE_URL}/research/start", headers=headers, json={
    "query": "AI regulation in the European Union 2025",
    "depth": "deep"
}).json()
job_id = job["job_id"]

# Poll for completion
import time
while True:
    status = requests.get(f"{BASE_URL}/research/status/{job_id}", headers=headers).json()
    if status["status"] == "completed":
        print(status["report"])
        break
    time.sleep(3)

result = requests.post(f"{BASE_URL}/agent/run", headers=headers, json={
    "task": "Research the top 5 competitors of Salesforce and compare their pricing",
    "tools": ["web_search"]
}).json()
print(result["output"])

with open("leads.xlsx", "rb") as f:
    job = requests.post(
        f"{BASE_URL}/bulk/submit",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"file": f},
        data={
            "input_column": "company_description",
            "prompt_template": "Classify this company: {text}. Reply with: B2B, B2C, or Both",
            "output_column": "classification"
        }
    ).json()

job_id = job["job_id"]
# Download result: GET /bulk/download/{job_id}

curl https://app.oceanicco.nl/api/v1/apikeys/verify \
  -H "Authorization: Bearer sk_live_ocean_YOUR_KEY"

# Response:
{
  "valid": true,
  "username": "your-username",
  "plan": "professional",
  "scopes": ["chat", "rag", "translate"],
  "auth_method": "api_key"
}

usage = requests.get(f"{BASE_URL}/usage", headers=headers).json()
print(f"Credits remaining: {usage['credits_remaining']}")
print(f"Plan: {usage['plan']}")

# Response:
{
  "username": "your-username",
  "plan": "professional",
  "credits_remaining": 4820,
  "credits_monthly": 6000,
  "trial_days_left": null
}