Skip to main content
Using a coding assistant? Choose Copy page or View as Markdown above, then use the coding assistant guide. The OpenAPI field names on this site are the exact HTTP contract.

Base URL

Authentication

Use an organization API key as a bearer token. Dashboard cookies are for human browser sessions and must not be used in an application.
Expected result: the response names your organization and current account limits without exposing the API key.

Safe retries

Use a unique Idempotency-Key for each new run. If a network failure leaves the response uncertain, retry with the same key and identical body.

Runs are asynchronous

Submitting work returns before the run finishes. Poll the status link until the run reaches completed, failed, cancelled, or expired.

Errors

Errors use a standard JSON shape. Read Errors and retries before implementing automatic retries.

Make your first API call

Check authentication without calling a provider.

Run a model

Submit a live task and read the result.