From first request to production.

curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-argon",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Hello, Allgate"}
    ]
  }'

{
  "id": "chatcmpl-01a14b8e3c9d71f2a1b2c3d4e5f6",
  "object": "chat.completion",
  "created": 1792269000,
  "model": "gemini-4-argon",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Allgate is a unified model gateway…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 22,
    "completion_tokens": 509,
    "total_tokens": 531
  }
}

curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/responses" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-argon",
    "input": "Explain Allgate in one sentence, then give me three key points."
  }'

{
  "id": "resp_01a14b8e44aa71c2b4d7f0e1a2b3c4d5",
  "object": "response",
  "created_at": 1792269000,
  "status": "completed",
  "model": "gemini-4-argon",
  "output": [
    {
      "type": "message",
      "id": "msg_01a14b8e44ab72d3c5e8f1a2b3c4d5e6",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Allgate is one gateway for every model capability…",
          "annotations": []
        }
      ]
    }
  ],
  "output_text": "Allgate is one gateway for every model capability…",
  "usage": {
    "input_tokens": 22,
    "output_tokens": 509,
    "total_tokens": 531
  }
}

curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/messages" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-argon",
    "max_tokens": 512,
    "system": "You are Allgate, a concise assistant.",
    "messages": [
      {"role": "user", "content": "Explain Allgate in one sentence."}
    ]
  }'

{
  "id": "msg_01a14b8e52bb73e4d6f901a2b3c4d5e6",
  "type": "message",
  "role": "assistant",
  "model": "gemini-4-argon",
  "content": [
    { "type": "text", "text": "Allgate is one OpenAI-compatible gateway in front of every model vendor." }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": { "input_tokens": 22, "output_tokens": 24 }
}

curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/embeddings" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_EMBEDDING_MODEL",
    "input": ["Allgate gateway", "openai compatible gateway"]
  }'

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0123, -0.0456, 0.0789]
    },
    {
      "object": "embedding",
      "index": 1,
      "embedding": [0.0234, -0.0567, 0.0891]
    }
  ],
  "model": "YOUR_EMBEDDING_MODEL",
  "usage": { "prompt_tokens": 6, "total_tokens": 6 }
}

# Submit once; a lost response is not permission to repeat a paid POST.
curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/images/generations" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.5-flare",
  "prompt": "A sculptural glass sphere above a calm silver sea",
  "n": 1,
  "size": "1024x1024",
  "quality": "auto",
  "output_format": "png"
}'

{
  "created": 1792269000,
  "data": [
    {
      "b64_json": "BASE64_IMAGE_BYTES"
    }
  ],
  "model": "gpt-image-2.5-flare"
}

# text-to-speech: the response body is audio, not JSON
curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/audio/speech" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_SPEECH_MODEL","input":"Hello, Allgate","voice":"alloy","response_format":"mp3"}' \
  -o speech.mp3

# speech-to-text: multipart/form-data upload
curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/audio/transcriptions" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -F model='YOUR_TRANSCRIPTION_MODEL' \
  -F response_format=json \
  -F file=@sample.wav

HTTP/1.1 200 OK
content-type: audio/mpeg
x-allgate-request-id: req_01a14b8e6a2d75c4d6e7f8a9b0c1d2e3
x-allgate-model: YOUR_SPEECH_MODEL

<binary audio bytes; Content-Type follows the provider response>

{
  "text": "Welcome to Allgate.",
  "task": "transcribe",
  "language": "en",
  "duration": 1.25,
  "segments": [
    { "id": 0, "start": 0.0, "end": 1.25, "text": "…" }
  ]
}

# Submit once; a lost response is not permission to repeat a paid POST.
curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/videos/generations" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedance-2-0-fast",
  "prompt": "A sculptural glass sphere above a calm silver sea",
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": false,
  "output_format": "mp4"
}'

# Save the returned id. Resume this GET after a connection loss.
TASK_ID='YOUR_TASK_ID'
curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/videos/generations/$TASK_ID" \
  -H "Authorization: Bearer $ALLGATE_API_KEY"

HTTP/1.1 202 Accepted

{
  "id": "01a14b8e7b3c74d5e6f7a8b9c0d1e2f3",
  "object": "video.generation",
  "status": "queued",
  "model": "doubao-seedance-2-0-fast",
  "created": 1792269000,
  "progress": 0,
  "prompt": "A sculptural glass sphere above a calm silver sea"
}

{
  "id": "01a14b8e7b3c74d5e6f7a8b9c0d1e2f3",
  "object": "video.generation",
  "status": "succeeded",
  "model": "doubao-seedance-2-0-fast",
  "created": 1792269000,
  "completed": 1792269005,
  "progress": 100,
  "prompt": "A sculptural glass sphere above a calm silver sea",
  "result": {
    "url": "https://media.example.com/private-video.mp4",
    "duration_secs": 5
  }
}

curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/rerank" \
  -H "Authorization: Bearer $ALLGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RERANK_MODEL",
    "query": "Allgate model gateway",
    "documents": [
      "The weather is nice today",
      "Allgate is a unified model gateway",
      "A cat is sitting on a mat"
    ],
    "top_n": 2
  }'

{
  "id": "rerank-01a14b8e8c5d76f7a8b9c0d1e2f3a4b5",
  "object": "rerank",
  "model": "YOUR_RERANK_MODEL",
  "results": [
    { "index": 1, "relevance_score": 0.792937 },
    { "index": 2, "relevance_score": 0.412108 }
  ],
  "usage": { "prompt_tokens": 31, "total_tokens": 31 }
}

curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/models" \
  -H "Authorization: Bearer $ALLGATE_API_KEY"

curl --fail-with-body --silent --show-error "$ALLGATE_BASE_URL/models/gemini-4-argon" \
  -H "Authorization: Bearer $ALLGATE_API_KEY"

{
  "object": "list",
  "data": [
    { "id": "gemini-4-argon", "object": "model", "created": 1704067200, "owned_by": "Allgate" }
  ]
}

{
  "id": "gemini-4-argon",
  "object": "model",
  "created": 1704067200,
  "owned_by": "Allgate"
}