NNexithDocs
ステータスダッシュボード ↗
概要とクイックスタートモデルカタログガイドAPI リファレンス連携OAuth2 / OIDC

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/* ルートは実装済みですが現在アップストリームが未設定であり、呼び出すと 502 inference_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 参照)。