API Reference

Stripe/OpenAI-style documentation for fast onboarding: one OpenAI-compatible endpoint, predictable auth, and production-ready request patterns.

Quickstart

Export your API key and call ArkAgentic in minutes. Use the same client SDKs you already use for OpenAI.

export ARK_API_KEY="sk-ark-xxxxxxxxxxxxxxxx"
export ARK_BASE_URL="https://api.arkagentic.com/v1"

Authentication

Pass your key in the Authorization header using Bearer Token format.

Authorization: Bearer $ARK_API_KEY

Model Hub

Unified routing across OpenAI, Claude, Gemini and top domestic models.

Global Mainstream

GPT-4o 路 Claude 3.5 路 Gemini

China Top AI

DeepSeek-V3/R1 路 Qwen 2.5 路 Kimi 路 GLM-4

Routing

Smart fallback 路 latency-aware 路 pay-as-you-go

Chat Completions

Endpoint: POST /v1/chat/completions

OpenAI-compatible schema with stable request/response contracts for Node.js and Python SDKs.

Embeddings

Endpoint: POST /v1/embeddings for RAG indexing and retrieval pipelines.

Error Codes

CodeMeaningTroubleshooting
401Invalid API keyCheck ARK_API_KEY and Bearer prefix
429Rate limit exceededApply backoff or increase quota
503Upstream unavailableRetry with fallback model route