API reference/Endpoints & examples

Endpoints & Request Examples

Wokey is compatible with the OpenAI and Anthropic API formats. This page lists every public endpoint and shows a request in each of the three text formats.

On this pageexpand_more

Endpoint listlink

POST/chat/completionsChat Completions

OpenAI Chat Completions-compatible format for most OpenAI SDKs and chat clients.

POST/responsesResponses

OpenAI Responses-compatible format. Recommended for Codex CLI.

POST/messagesMessages

Anthropic Messages-compatible format for Claude Code and Anthropic SDKs. Native Messages requests must include max_tokens; use /chat/completions for OpenAI-style requests.

POST/images/generationsImage Generations

OpenAI Images-compatible format for gpt-image-2.5. Unlike text APIs, image requests use separate size, response, and per-image billing rules. Read more →

POST/v1/videosVideo Generations

Asynchronous video generation. Submission returns a job ID; poll the status endpoint and download the finished video. Read more →

GET/modelsModels

Returns available text models by default. Use output_modalities=image, video, or all to discover currently callable media models.

GET/v1/models/pricingModel Pricing

Returns normalized pricing for currently callable text, image, and video models, filterable by output modality or exact model ID.

GET/v1/images/modelsImage Models

Returns currently callable image models with supported parameters, dimension limits, and per-image pricing tiers.

GET/v1/videos/modelsVideo Models

Returns video models with at least one sellable variant, including modes, resolutions, durations, aspect ratios, and per-second prices.

Pathslink

The gateway also supports /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations, and /v1/models paths. Video generation uses /v1/videos.

Request exampleslink

OpenAI Chat Completions

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

OpenAI Responses

cURL
curl https://api.wokey.ai/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "instructions": "You are a helpful assistant.",
    "input": [
      { "role": "user", "content": "Hello" }
    ],
    "store": false,
    "stream": false
  }'

Anthropic Messages

cURL
curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'