POST
/v1/chat
Create a chat completion
Example Request
cURL
Developer Platform · v2.4 is live
Build with the AI API
One clean REST interface for chat, embeddings, images and models. Ship your first request in under five minutes with typed SDKs, copy-paste examples and a simulated playground — no key required to explore.
Core Developer Resources
Quickstart
From zero to your first AI completion in three steps. Copy each command as you go — the whole thing takes about five minutes.
Install the SDK
Grab the official client from npm. It ships TypeScript types, automatic retries and streaming helpers, and works with Node 18+ and every major bundler.
$ npm install ai-sdk
Configure your API key
Create a secret key in the dashboard, then expose it to your shell. The SDK picks up AI_API_KEY automatically — never hard-code keys or ship them to the browser.
$ export AI_API_KEY="sk-…your-key…"
Make your first request
Send a message to gpt-4o-mini and print the assistant's reply. Swap the model or add stream: true when you're ready for more.
const res = await ai.chat.create({ messages: [{ role: "user", content: "Hello!" }] })
API Reference
All routes live under https://api.ai.com and authenticate with a bearer token. Pick an endpoint to see its contract.
API Playground
Compose a request on the left, hit Send Request, and inspect the response on the right. Everything runs locally — responses are simulated and nothing leaves your browser.
Request
simulated · no key required
GET request — no body required.
This endpoint takes no JSON payload. Just press Send Request to list the models available to your key.
This endpoint takes no JSON payload. Just press Send Request to list the models available to your key.
⌘⏎ to send
Response (Simulated)
200 OK
Send a request to see the simulated
response appear here. Tip: edit the JSON body first — errors are simulated too.
response appear here. Tip: edit the JSON body first — errors are simulated too.