Chat Completions API

Xenodia の OpenAI-compatible chat endpoint をチャット、server-side text generation、agent workflow で使う。

POST /v1/chat/completions は Xenodia 経由の OpenAI-compatible チャットと text generation endpoint です。

Endpoint

POST https://api.xenodia.xyz/v1/chat/completions

Authentication

Authorization: Bearer YOUR_LONG_TERM_KEY

Minimal request

{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK only."
    }
  ]
}

cURL

curl -X POST "https://api.xenodia.xyz/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XENODIA_API_KEY" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "You are a precise test assistant." },
      { "role": "user", "content": "Reply with OK only." }
    ],
    "temperature": 0
  }'

Success response

{
  "id": "chatcmpl-xxx",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "OK"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 1,
    "total_tokens": 19
  }
}

Compatibility

Request shape は OpenAI Chat Completions に合わせています。多くの場合、base URL、API key、model ID を変更し、Model Discovery から Xenodia model ID を選ぶだけで移行できます。

現在の gateway response は model response から保存する標準フィールド id、choices[].message、usage を返します。object、created、choices[].index、choices[].finish_reason は自前 adapter が追加しない限り必須にしないでください。

Production guidance

model ID を固定する前に /v1/models を問い合わせる。
capability data が公開していない model-specific parameter は optional として扱う。
非冪等 workflow の retry は控えめにする。
raw prompt や API key ではなく request ID と status code を記録する。