1. Quickstart
Use your existing OpenAI SDK. Only change base URL tohttps://arkagentic.com/v1and pass your ArkAgentic 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 ID | Category | Alias / Route Target | Notes |
|---|---|---|---|
| No models matched your filters. | |||
For detailed token pricing and compute estimator, visitPricing β.
View all 0 models in Model Center β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
| Code | Meaning | Suggested Action |
|---|---|---|
| 400 | Invalid request payload | Validate JSON shape and model ID. |
| 401 | Unauthorized | Check Bearer token and key scope. |
| 429 | Rate limited | Apply exponential backoff and retry. |
| 5xx | Transient upstream/gateway failure | Retry with jitter; gateway may auto-failover. |