Developer Documentation

Welcome to ArkAgentic Developer API docs. Integrate global SOTA models with one endpoint.

1. Quickstart

Use your existing OpenAI SDK. Only change base URL tohttps://arkagentic.com/v1and pass your ArkAgentic API key.

Get API Key βž”

cURL Β· bash

curl https://arkagentic.com/v1/chat/completions \
  -H "Authorization: Bearer <YOUR_API_KEY>" \\
  -H "Content-Type: application/json" \
  -d '{
    "model": "ark-gpt-4o",
    "messages": [{"role":"user","content":"Hello from ArkAgentic"}],
    "temperature": 0.2,
    "stream": true
  }'

2. Model Routing Directory

Pass standard ArkAgentic model IDs in model. Gateway can map aliases and upstream overrides internally while your client integration stays stable.

Model IDCategoryAlias / Route TargetNotes
No models matched your filters.

For detailed token pricing and compute estimator, visitPricing βž”.

View all 0 models in Model Center βž”
Page 1 / 1

3. Advanced Gateway Features

Failover & Auto-Retry

If an upstream node is degraded or unavailable, gateway automatically reroutes and retries to healthy candidates with no client-side route change.

Streaming SSE

Standard OpenAI-compatible streaming is supported. Setstream: trueand consume Server-Sent Events in your existing client.

Streaming Request

{
  "model": "ark-gpt-4o",
  "messages": [{"role":"user","content":"stream this response"}],
  "stream": true
}

HTTP Status Codes & Error Handling

CodeMeaningSuggested Action
400Invalid request payloadValidate JSON shape and model ID.
401UnauthorizedCheck Bearer token and key scope.
429Rate limitedApply exponential backoff and retry.
5xxTransient upstream/gateway failureRetry with jitter; gateway may auto-failover.