Nexith API ドキュメント
バージョン:v1 · 更新:2026-11-19 対象:
https://api.nexith.ai/v1(同値のエイリアスhttps://gateway.nexith.ai/v1)
Nexith は OpenAI 互換の推論ゲートウェイを提供します。チャット、Responses、Anthropic Messages、
画像生成/画像編集、非同期ジョブ、ファイルアップロード、会話同期は、すべて同一の /v1 エンドポイントと
同一の API Key を使用します。その上で、少数の nexith_* リクエストフィールドと nexith.* レスポンスフレームが、
Web 検索、画像生成意図の識別、長期記憶などのプラットフォーム機能を提供します。これらのフィールドを
送信しない通常の OpenAI クライアントの動作はまったく変わりません。
ドキュメントマップ#
| セクション | 内容 |
|---|---|
| モデルカタログ | 利用可能なモデル、機能、コンテキスト、価格 |
| nexith-core | テキスト/推論/視覚のメインモデル |
| nexith-image | 画像生成と画像編集 |
| 料金 | テキスト token、キャッシュ、画像の課金基準 |
| 提供終了履歴 | 提供終了済みモデルと移行方法 |
| ストリーミングプロトコル | SSE フレーム形式、nexith.* サイドチャネルフレーム |
| 画像ガイド | 生成/編集/非同期ジョブの完全なフロー |
| エラーとレート制限 | エラーコード、HTTP ステータス、429 と再試行 |
| Chat Completions | POST /v1/chat/completions |
| Responses | POST /v1/responses |
| Messages | POST /v1/messages(Anthropic 互換) |
| Images | POST /v1/images/generations、/v1/images/edits |
| Jobs | 非同期ジョブの照会、キャンセル、SSE |
| Files | POST /v1/files |
| Conversations | 会話同期 CRUD |
| Models | GET /v1/models |
Base URL#
| 環境 | Base URL | 説明 |
|---|---|---|
| 本番(推奨) | https://api.nexith.ai/v1 |
OpenAI スタイルの単一ドメイン。すべてのモデルエンドポイントが利用可能 |
| 本番(エイリアス) | https://gateway.nexith.ai/v1 |
推奨アドレスと完全に同一の動作 |
| ローカル開発 | http://localhost:8080/v1 |
gateway に直接接続 |
api.nexith.aiはコンソール BFF(/v1/billing、/v1/api-keys、/v1/adminなど)も提供します。 これらはモデルエンドポイントではなく、本ドキュメントの対象外です。
認証#
すべての /v1 モデルエンドポイントは認証が必要です。2 種類の認証情報をサポートします:
| 方式 | Header | 対象 |
|---|---|---|
| API Key(推奨) | Authorization: Bearer nx-... |
すべてのエンドポイント |
| JWT(ログインセッション) | Authorization: Bearer eyJ... |
すべてのエンドポイント(chat サイト内部で使用) |
| Anthropic スタイル | x-api-key: nx-... |
/v1/messages、/v1/messages/count_tokens のみ |
API Key は開発者コンソール(platform.nexith.ai)で作成し、nx-xxxxxxxx の形式です。
Key の権限、RPM/TPM、残高はすべてサーバー側の記録が正となります。リクエスト内の user フィールドは
アップストリームへそのまま渡すメタデータとしてのみ扱われ、認証や課金の帰属には関与しません。
/v1/images/editsは chat サイト専用の画像編集エンドポイントです。JWT のみ受け付け、nx-Key は一律 403 になります。
クイックスタート#
curl#
curl https://api.nexith.ai/v1/chat/completions \
-H "Authorization: Bearer $NEXITH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nexith-core",
"messages": [{"role": "user", "content": "用一句话解释什么是向量数据库"}]
}'OpenAI Python SDK#
from openai import OpenAI
client = OpenAI(
api_key="nx-...",
base_url="https://api.nexith.ai/v1",
)
resp = client.chat.completions.create(
model="nexith-core",
messages=[{"role": "user", "content": "hello"}],
)
print(resp.choices[0].message.content)画像生成(非同期ジョブ)#
# 1) 提交作业
curl https://api.nexith.ai/v1/images/generations \
-H "Authorization: Bearer $NEXITH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "nexith-image", "prompt": "a red apple on a white table"}'
# → 202 {"id": 123, "status": "pending", ...}
# 2) 轮询(或订阅 /v1/jobs/123/events)
curl https://api.nexith.ai/v1/jobs/123 \
-H "Authorization: Bearer $NEXITH_API_KEY"
# → {"status":"completed","artifacts":["https://..."]}エンドポイント一覧#
| メソッド | パス | 説明 | ドキュメント |
|---|---|---|---|
| POST | /v1/chat/completions |
OpenAI Chat Completions | 詳細 |
| POST | /v1/responses |
OpenAI Responses アダプター(Codex など) | 詳細 |
| POST | /v1/messages |
Anthropic Messages アダプター(Claude Code) | 詳細 |
| POST | /v1/messages/count_tokens |
Anthropic token カウント | 詳細 |
| GET | /v1/models |
利用可能なモデルの一覧 | 詳細 |
| POST | /v1/images/generations |
画像生成ジョブを送信 | 詳細 |
| POST | /v1/images/edits |
画像編集ジョブを送信(JWT のみ) | 詳細 |
| GET | /v1/jobs/:id |
ジョブの状態と成果物 | 詳細 |
| GET | /v1/jobs/:id/events |
ジョブイベント SSE | 詳細 |
| POST | /v1/jobs/:id/cancel |
ジョブをキャンセル | 詳細 |
| POST | /v1/files |
画像をアップロードし、nx-file:// 参照を返す |
詳細 |
| GET/POST | /v1/conversations |
会話一覧 / 作成 | 詳細 |
| GET/PATCH/DELETE | /v1/conversations/:id |
会話の取得 / 更新 / 削除 | 詳細 |
/v1/embeddings、/v1/audio/*ルートは実装済みですが現在アップストリームが未設定であり、呼び出すと 502inference_unavailableを返します。そのため公開ドキュメントではまだ保証していません。提供開始時に別途お知らせします。
互換性#
| クライアント | 接続方式 | 説明 |
|---|---|---|
| OpenAI SDK | base_url=https://api.nexith.ai/v1 |
Chat Completions / Responses のいずれも可 |
| Codex CLI | wire_api = "responses" |
Responses 参照 |
| Claude Code | ANTHROPIC_BASE_URL=https://api.nexith.ai |
Messages 参照 |
| OpenCode / その他 | OpenAI Chat 互換 | Chat Completions 参照 |
規約#
- 金額の単位:ドキュメントと API の価格はすべて USD です。内部の会計はマイクロドル(1e-6 USD)の整数で記帳します。
- 時刻:すべてのタイムスタンプは Unix 秒(
created)または RFC3339 UTC 文字列です。 - エラー形式:
{"error":{"message","type","code"}}に統一されています。詳細はエラーとレート制限を参照してください。 - ストリーミング:
text/event-stream。フレームはdata: <json>で送信し、data: [DONE]で終了します。 - 不透明性:アップストリームのプロバイダー、実際のモデル名、内部エラーの原文はレスポンスに現れません。ジョブの失敗時は 不透明な理由のみを返します(Jobs 参照)。