Public Developer API · v1

Build with Orbit AI.

Use Orbit completions and your Orbit agents from external applications through a secure, key-authenticated API.

Open Developer DashboardCreate accountOrbit Rules
Overview

API base URL

https://api.orbitdev.org/v1

AI completions

Send chat-style messages and receive an Orbit AI response.

Agent runs

Start asynchronous runs for agents owned by your Orbit account.

Usage analytics

Review recent requests, remaining quotas, latency, and credit usage.

Secure keys

Raw keys are shown once and stored by Orbit only as secure hashed records.

Authentication

Use an API key

Create keys in the Developer Dashboard. Send the key in every request as a Bearer token.

Authorization: Bearer orb_your_api_key
Keep keys server-side. Do not place API keys in public browser code, mobile bundles, repositories, or logs. Revoke or regenerate exposed keys immediately.
Access tiers

Limits and Orbit credits

TierMinute limitMonthly limitAccess
Free5 requests100 requestsIncluded with an Orbit account
Paid30 requests10,000 requestsOne-time €10 payment

Cost-bearing AI and agent requests consume one Orbit credit. Usage and agent-result reads do not consume credits.

Reference

Endpoints

MethodPathPurpose
POST/chat/completionsCreate an AI response from up to 40 messages.
POST/agents/{agentId}/runsStart an asynchronous run for an agent owned by the API-key account.
GET/agent-runs/{runId}Read status, result, or error for an owned run.
GET/usageRead recent API usage and remaining limits.
Quick start

Example request

curl https://api.orbitdev.org/v1/chat/completions \
  -H "Authorization: Bearer orb_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Explain orbital velocity"}]}'

Start an agent run

curl https://api.orbitdev.org/v1/agents/YOUR_AGENT_ID/runs \
  -H "Authorization: Bearer orb_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"goal":"Research and summarize the latest project notes"}'
Errors

Consistent error responses

{"error":{"code":"rate_limit_exceeded","message":"Minute rate limit exceeded","request_id":"..."}}

Common statuses: 401 invalid key, 402 insufficient credits, 422 validation error, 429 quota exceeded, and 500 unexpected server error. Responses include request and rate-limit headers.