API Reference.

curl https://api.outrun.to/v1/responses \
  -H "Authorization: Bearer $OUTRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-sol", "input": "Write a haiku about rivers.", "reasoning": {"effort": "high"}}'

curl https://api.outrun.to/v1/messages \
  -H "x-api-key: $OUTRUN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 256, "messages": [{"role": "user", "content": "Hello, Claude"}]}'

# Count tokens before sending:
curl https://api.outrun.to/v1/messages/count_tokens \
  -H "x-api-key: $OUTRUN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5", "messages": [{"role": "user", "content": "Hello, Claude"}]}'

curl "https://api.outrun.to/v1/gemini-cli/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $OUTRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"role": "user", "parts": [{"text": "Explain DNS in one sentence."}]}]}'

# Streaming (server-sent events); the key can also go in ?key=
curl "https://api.outrun.to/v1/gemini-cli/v1beta/models/gemini-3.8-flash:streamGenerateContent?alt=sse&key=$OUTRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"role": "user", "parts": [{"text": "Count to five."}]}]}'

curl https://api.outrun.to/v1/models \
  -H "Authorization: Bearer $OUTRUN_API_KEY"

curl https://api.outrun.to/v1/images/generations \
  -H "Authorization: Bearer $OUTRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3-pro-image", "prompt": "A lighthouse at dawn, oil painting", "size": "16:9"}'

# Response: {"created": 1790000000, "data": [{"b64_json": "<base64 PNG>"}], "usage": {...}}
# Gemini image models return one image per request (n = 1).
# gpt-image-2 and grok-imagine-image use the same request shape.

curl https://api.outrun.to/v1/audio/speech \
  -H "Authorization: Bearer $OUTRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3.1-tts", "input": "Welcome to Outrun.", "voice": "Kore", "response_format": "wav"}' \
  --output speech.wav

# Use a Gemini voice name (for example Kore) and response_format wav or pcm.

# macOS / Linux: put the audio file into a JSON body as base64
B64=$(base64 < clip.mp3 | tr -d '\n')
cat > stt.json <<EOF
{"model": "gemini-3-stt",
 "messages": [{"role": "user", "content": [
   {"type": "text", "text": "Transcribe this audio."},
   {"type": "input_audio", "input_audio": {"data": "$B64", "format": "mp3"}}
 ]}]}
EOF
curl https://api.outrun.to/v1/chat/completions \
  -H "Authorization: Bearer $OUTRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d @stt.json

# 1) Start a task
curl https://api.outrun.to/v1/videos \
  -H "Authorization: Bearer $OUTRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1-fast", "prompt": "A paper boat drifting down a rainy street", "seconds": 4, "size": "16:9"}'
# -> returns a task id and "status": "queued"

# 2) Check it every few seconds until "status" is "completed" (or "failed")
curl https://api.outrun.to/v1/videos/VIDEO_ID \
  -H "Authorization: Bearer $OUTRUN_API_KEY"

# 3) Download the mp4
curl -L https://api.outrun.to/v1/videos/VIDEO_ID/content \
  -H "Authorization: Bearer $OUTRUN_API_KEY" \
  -o video.mp4

curl https://api.outrun.to/v1/account \
  -H "Authorization: Bearer $OUTRUN_API_KEY"

# Response: {"currency": "USD", "credit": 12.34}