OpenAI 互換の API:1 つのエンドポイントと 1 つの Key で、GPT・Claude・Gemini・DeepSeek などの対話モデルと画像・動画生成を利用できます。以下のサンプルはすべてそのまま動きます。
クイックスタート
Base URL と API Key を差し替えるだけで、既存の OpenAI SDK がそのまま使えます。
https://nezhagate.com/v1
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "gpt-5.5", "messages": [{"role": "user", "content": "AI API の短い製品紹介を書いてください"}], "stream": false}'
モデルごとの完全なリクエストパラメータ、サンプル、非同期の使い方は、そのモデル専用のドキュメントにあります。下のモデルと料金の表から開いてください。
そのまま動かせるサンプルはこちら(Python / Node / curl。画像と動画の非同期フローを含みます): github.com/gaoorange/nezhagate-api-examples
認証方式
すべての API 呼び出しには Bearer Token が必要です。
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
モデルと価格
モデルごとの完全なリクエストパラメータ、サンプル、非同期の使い方は、そのモデル専用のドキュメントにあります。下のモデルと料金の表から開いてください。
| モデル | 能力 | エンドポイント | 価格 | |
|---|---|---|---|---|
| gpt-5.6-sol | 最前線の推論、エージェント型コーディング、長期タスク、構造化出力 | /chat/completions | 入力 $1.2/1M · 出力 $6.0/1M | API ドキュメント → |
| gpt-5.6-luna | 高速なチャット、エージェント型コーディング、大量かつ低レイテンシ、構造化出力 | /chat/completions | 入力 $0.07/1M · 出力 $0.4/1M | API ドキュメント → |
| gpt-6-astra | 深い推論、エージェント型コーディング、非常に長いコンテキスト、画像入力、構造化出力 | /chat/completions | 入力 $3.0/1M · 出力 $15.0/1M | API ドキュメント → |
| gpt-6.1-sol | エージェント型コーディング、複雑なコーディング、専門的な文書・分析業務、推論、非常に長いコンテキスト、画像入力、構造化出力 | /chat/completions | 入力 $0.6/1M · 出力 $3.0/1M | API ドキュメント → |
| gpt-6-sol | 複雑なコーディング、エージェント型ワークフロー、推論、非常に長いコンテキスト、画像入力、構造化出力 | /chat/completions | 入力 $0.6/1M · 出力 $3.0/1M | API ドキュメント → |
| gpt-6-luna | 大量のチャット、低レイテンシのエージェントステップ、分類と抽出、非常に長いコンテキスト、構造化出力 | /chat/completions | 入力 $0.07/1M · 出力 $0.4/1M | API ドキュメント → |
| gpt-image-2 | テキストから画像、画像から画像、カバー、ポスター、イラスト | /images/generations | 1K $0.005 · 2K $0.025 · 4K $0.04 | API ドキュメント → |
| gpt-image-2.5-flare | テキストから画像、画像から画像、カバー、ポスター、イラスト、文字組み | /images/generations | 1K $0.005 · 2K $0.03 · 4K $0.05 | API ドキュメント → |
| gpt-image-2.5-sunburst | テキストから画像、画像から画像、カバー、ポスター、イラスト、文字組み | /images/generations | 1K $0.005 · 2K $0.03 · 4K $0.05 | API ドキュメント → |
| nano-banana-2 | テキストから画像、画像から画像、カバー、ポスター、イラスト | /images/generations | 1K $0.015 · 2K $0.025 · 4K $0.04 | API ドキュメント → |
| nano-banana-pro | テキストから画像、画像から画像、カバー、ポスター、イラスト、インフォグラフィック | /images/generations | 1K $0.02 · 2K $0.03 · 4K $0.05 | API ドキュメント → |
| nano-banana-2.1 | テキストからの画像生成、画像編集、複数画像の合成、ポスターやインフォグラフィック、商品画像、横長バナー | /images/generations | 1K $0.015 · 2K $0.025 · 4K $0.04 | API ドキュメント → |
| grok-imagine-image | テキストからの画像生成、画像編集、ポスター、商品画像、SNS 用ビジュアル、中国語と英語の文字 | /images/generations | 1K $0.005 · 2K $0.005 · 4K $0.0 | API ドキュメント → |
| grok-imagine-image-quality | カバー、ポスター、商品画像、イラスト、テキストからの生成と画像編集 | /images/generations | 1K $0.01 · 2K $0.01 · 4K $0.0 | API ドキュメント → |
| claude-sonnet-4-6 | チャット、コード、推論、長いコンテキスト | /chat/completions | 入力 $1.5/1M · 出力 $7.5/1M | API ドキュメント → |
| claude-opus-5 | 深い推論、コード、エージェント、長いコンテキスト、画像理解 | /chat/completions | 入力 $4.0/1M · 出力 $20.0/1M | API ドキュメント → |
| claude-fable-5 | 中国語の執筆、物語の創作、長文生成、チャット、コード、画像理解 | /chat/completions | 入力 $8.0/1M · 出力 $40.0/1M | API ドキュメント → |
| claude-opus-5-5 | 複雑な推論、長時間のエージェント型コーディング、コードエンジニアリング、ツール呼び出し、画像と PDF の理解 | /chat/completions | 入力 $2.5/1M · 出力 $12.5/1M | API ドキュメント → |
| claude-sonnet-5-5 | 日常のコーディングとエージェント、長いコンテキスト、ツール呼び出し、画像と PDF の理解、大規模な本番トラフィック | /chat/completions | 入力 $1.5/1M · 出力 $7.5/1M | API ドキュメント → |
| gemini-4-argon | Beta · 推論 · 長いコンテキスト | /chat/completions | 入力 $0.5/1M · 出力 $3.0/1M | API ドキュメント → |
| gemini-3.1-pro | チャット、推論、非常に長いコンテキスト、マルチモーダル | /chat/completions | 入力 $0.5/1M · 出力 $3.0/1M | API ドキュメント → |
| gemini-3.8-flash | チャット、推論、適応的な思考、画像入力、非常に長いコンテキスト | /chat/completions | 入力 $0.6/1M · 出力 $3.6/1M | API ドキュメント → |
| deepseek-v4.1-flash | チャット、推論、コーディング、ツール呼び出し、思考モードの切り替え | /chat/completions | 入力 $0.075/1M · 出力 $0.3/1M | API ドキュメント → |
| deepseek-v4-flash-0731 | チャット、推論、コーディング、ツール呼び出し、思考モードの切り替え、バージョン固定 | /chat/completions | 入力 $0.13/1M · 出力 $0.51/1M | API ドキュメント → |
| glm-5.3 | チャット、コーディング、エージェントワークフロー、推論、中国語・英語の文章作成、ツール呼び出し | /chat/completions | 入力 $1.12/1M · 出力 $3.52/1M | API ドキュメント → |
| qwen3.8-max | 推論、コーディング、エージェントとツール呼び出し、中国語・英語の文章作成、画像理解 | /chat/completions | 入力 $1.4/1M · 出力 $4.2/1M | API ドキュメント → |
| qwen3.8-flash | 大量のチャット、分類と抽出、要約と書き換え、画像理解と OCR、ツール呼び出し | /chat/completions | 入力 $0.1/1M · 出力 $0.33/1M | API ドキュメント → |
| grok-4.7 | 複雑な推論、コーディング、長文ドキュメント分析、ツール呼び出し、構造化出力、画像理解 | /chat/completions | 入力 $0.3/1M · 出力 $0.9/1M | API ドキュメント → |
| veo-3.1 | ショート動画、製品モーション、フレーム間のトランジション、商用映像 | /videos/generations | $0.2 /本+ | API ドキュメント → |
| gemini-omni-flash | 複数カットの短編、絵コンテ通りのストーリー、フレーム間のトランジション | /videos/generations | $0.05 /秒 | API ドキュメント → |
| kling-4.0 | 人物のアクション、商品ショート動画、参照動画の動きの再現 | /videos/generations | $0.09 /秒 | API ドキュメント → |
| seedance-2.5-token | テキスト・画像・動画・音声の参照 | /videos/generations | $7.50–13.75 /1M video tokens | API ドキュメント → |
| seedance-2.5-token-draft | テキスト・画像・動画・音声の参照 | /videos/generations | $7.50–12.50 /1M video tokens | API ドキュメント → |
| seedance-2.5 | 長回しの短編、複数参照素材の入力、商用映像 | /videos/generations | $0.158 /秒 | API ドキュメント → |
| seedance-2.0 | 短編クリップ、商用素材 | /videos/generations | $0.15 /秒 | API ドキュメント → |
| seedance-2.0-fast | 大量の素材制作、アイデアの素早い検証 | /videos/generations | $0.075 /秒 | API ドキュメント → |
| seedance-2.0-clip | 実在の人物が出る短編、商品動画、まとめての量産 | /videos/generations | $1.0 /本+ | API ドキュメント → |
| seedance-2.5-30s | 長回しのストーリーテリング、長尺の製品動画 | /videos/generations | $2.0 /本+ | API ドキュメント → |
| wan3.0-video | 長回しの語り、複数素材の合成、動画の書き換え | /videos/generations | $0.065 /秒 | API ドキュメント → |
| wan3.0-video-prime | 締め切りのある映像、まとめてのテスト撮影 | /videos/generations | $0.112 /秒 | API ドキュメント → |
| minimax-h3 | 高精細な映像、音声付きの短編クリップ | /videos/generations | $0.036 /秒 | API ドキュメント → |
| grok-imagine-video-1.5 | 大量の短尺動画、アイデアの素早い確認 | /videos/generations | $0.3 /本+ | API ドキュメント → |
アプリで使う(コード不要)
OpenAI API に対応したアプリなら、次の 3 つを入力するだけで使えます。プログラミングは不要です。
| API の Base URL | https://nezhagate.com/v1 |
| API キー | コンソールで作成したキー(コンソール → API キー → コピー) |
| モデル名 | gpt-5.6-sol gpt-5.6-luna gpt-6-astra gpt-6.1-sol gpt-6-sol gpt-6-luna gpt-image-2 gpt-image-2.5-flare gpt-image-2.5-sunburst nano-banana-2 nano-banana-pro nano-banana-2.1 grok-imagine-image grok-imagine-image-quality claude-sonnet-4-6 claude-opus-5 claude-fable-5 claude-opus-5-5 claude-sonnet-5-5 gemini-4-argon gemini-3.1-pro gemini-3.8-flash deepseek-v4.1-flash deepseek-v4-flash-0731 glm-5.3 qwen3.8-max qwen3.8-flash grok-4.7 veo-3.1 gemini-omni-flash kling-4.0 seedance-2.5-token seedance-2.5-token-draft seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-clip seedance-2.5-30s wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5 |
ChatBox、Cherry Studio、NextChat、LobeChat、Immersive Translate、Open WebUI などで動作を確認しています。
クライアント別の手順ガイド:SillyTavern · Cherry Studio · Cline
ネイティブ Anthropic API(Claude Code)
OpenAI 互換のルートに加えて、Claude モデルはネイティブの Anthropic Messages API でも提供しています。Claude Code(または任意の Anthropic SDK)を下の Base URL に向け、ゲートウェイのキーを x-api-key として使うだけです。thinking、ツール呼び出し、プロンプトキャッシュはいずれもそのまま利用できます。
export ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic export ANTHROPIC_API_KEY=YOUR_API_KEY # claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / claude-opus-5-5 / claude-sonnet-5-5
curl https://nezhagate.com/anthropic/v1/messages -H "x-api-key: YOUR_API_KEY" -H "anthropic-version: 2023-06-01" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'
モデル:claude-opus-5-5、claude-sonnet-5-5、claude-opus-5、claude-sonnet-5、claude-fable-5、claude-sonnet-4-6。課金は /v1 とまったく同じトークン単位です。
プロンプトキャッシュの課金:キャッシュヒット(読み取り)は入力単価の 1/10(0.1×)、書き込みは 1.25× で課金します(モデルごとの単価は料金ページをご覧ください)。ヒットさせるには、十分に長く安定した接頭部(Claude Opus は 4096 トークン以上、Sonnet は 2048 以上)を短い間隔で繰り返す必要があります。大きな CLAUDE.md やシステムプロンプトを抱えた Claude Code で実際のコードベースを扱うと毎ターンヒットし、入力コストは約 1/10 になります。プレイグラウンドの短いやり取りは短すぎてキャッシュされません。
動画生成(非同期)
テキストから動画・画像から動画はいずれも非同期ジョブです。呼び出すと即座に HTTP 202 とジョブ ID が返り({"id":"img_...","object":"video.generation.job","status":"queued"})、GET /v1/videos/jobs/{id} を status=succeeded になるまでポーリングして、結果を data[0].url から取得します(再ホストした mp4)。1 本あたり 1〜12 分です。課金方式は 2 種類あり、Veo 3.1 は 1 本ごと、Seedance 2.x と MiniMax H3 は秒単位(単価 x 長さ)です。どちらも確保額と請求額は一致し、失敗時は全額返金します。画面比率は size で指定し(既定は横向きの 16:9)、画像から動画にする場合は image に最初のフレームとなる参照画像を渡してください。
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "veo-3.1", "prompt": "夕暮れにサーフィンをする猫", "tier": "fast", "resolution": "1080p", "size": "16:9"}'curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'
動画モデル: veo-3.1 gemini-omni-flash kling-4.0 seedance-2.5-token seedance-2.5-token-draft seedance-2.5 seedance-2.0 seedance-2.0-fast seedance-2.0-clip seedance-2.5-30s wan3.0-video wan3.0-video-prime minimax-h3 grok-imagine-video-1.5
Webhook:タスク終了時に自動で通知
動画と画像の生成は非同期です。リクエストを送るとタスク ID が返り、結果は少し後で届きます。ポーリングを繰り返さなくても、タスクが終わった時点で結果をご指定のサーバーへ送信します。残高が少なくなったときにもお知らせできます。
ポーリングしたくない場合は、送信時に callback_url を付けると、タスク終了時に結果をサーバーへ送信します。コンソールで既定の送信先を設定することもできます。 Webhook ドキュメント →
Agent Skills:AI コーディングアシスタントに一言で動画を作らせる
Claude Code、Codex、Cursor などスキル対応のアシスタントに NezhaGate のスキルを入れれば、「この画像を seedance-2.5 で 8 秒の動画にして ./out に保存して」と頼むだけ。モデル選び、素材のアップロード、レンダリング待ち、保存まで自動で行います。現在は Seedance 2.5 / 2.0 の動画スキルを提供しています。
npx skills add https://nezhagate.com
export NEZHAGATE_API_KEY=YOUR_API_KEY
github.com/gaoorange/nezhagate-skills · デモ動画(8 秒、1 回のリクエストで生成)
AI に渡す統合用の説明
下のブロック全体を Codex / Claude Code / Cursor に送れば、統合方法を理解します。右上の「ページをコピー」でドキュメント全文をコピーすることもできます。
Integrate NezhaGate through its OpenAI-compatible API.
Base URL: https://nezhagate.com/v1
API Key: read it from the environment variable NEZHAGATE_API_KEY.
Claude models can also use the native Anthropic protocol (for Claude Code / the Anthropic SDK): ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic, headers x-api-key=API Key and anthropic-version: 2023-06-01, POST /anthropic/v1/messages (max_tokens is required), models claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / claude-opus-5-5 / claude-sonnet-5-5.
Chat models (/chat/completions): gpt-5.6-sol / gpt-5.6-luna / gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna / claude-sonnet-4-6 / claude-opus-5 / claude-fable-5 / claude-opus-5-5 / claude-sonnet-5-5 / gemini-4-argon / gemini-3.1-pro / gemini-3.8-flash / deepseek-v4.1-flash / deepseek-v4-flash-0731 / glm-5.3 / qwen3.8-max / qwen3.8-flash / grok-4.7
Image models (text-to-image /images/generations; image-to-image /images/edits or add an image parameter): gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / nano-banana-2 / nano-banana-pro / nano-banana-2.1 / grok-imagine-image / grok-imagine-image-quality
Video models (/videos/generations, async jobs; add reference images for image-to-video; how each model uses them is in its own doc): veo-3.1 / gemini-omni-flash / kling-4.0 / seedance-2.5-token / seedance-2.5-token-draft / seedance-2.5 / seedance-2.0 / seedance-2.0-fast / seedance-2.0-clip / seedance-2.5-30s / wan3.0-video / wan3.0-video-prime / minimax-h3 / grok-imagine-video-1.5
Auth: Authorization: Bearer YOUR_API_KEY
Requirements (chat): return choices[0].message.content; on 401 check the key, 402 means insufficient balance, 429/5xx can be retried.
Requirements (images, async): POST /images/generations or /images/edits returns HTTP 202 with a job id right away ({"id":"img_...","object":"image.generation.job","status":"queued"}); then poll GET /v1/images/jobs/{id} until status=succeeded and read data[0].url (an img.nezhagate.com link kept for 15 days; download it or copy it to your own storage). Do not read data right after submitting.
Requirements (video, async): POST /videos/generations returns HTTP 202 with a job id (object=video.generation.job); then poll GET /v1/videos/jobs/{id} until status=succeeded and read data[0].url (a re-hosted mp4 link kept for 15 days). Render time varies by model (from a minute or two to over an hour); failed jobs are refunded in full.
残高と利用状況の確認
任意の API キーで、アカウントの残高と消費額を取得できます。管理画面へのログインは不要です。いちばん簡単なのは GET /v1/usage です。OpenAI 互換の /v1/dashboard/billing/credit_grants も使えます(残高は total_available)。
curl https://nezhagate.com/v1/usage -H "Authorization: Bearer YOUR_API_KEY"
curl https://nezhagate.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_API_KEY"
エラーコード
/v1 のエンドポイントのエラーは下の構造です(/anthropic のエンドポイントは Anthropic の形式)。code は変わらない機械可読の識別子なので、message の文面ではなく code で判定してください。
{
"error": {
"message": "human readable",
"type": "invalid_request_error | authentication_error | permission_error | insufficient_quota | rate_limit_error | server_error",
"code": "stable_snake_case",
"param": "field_name_or_null"
}
}
| HTTP | 意味 |
|---|---|
| 400 | パラメータの誤り、または存在しないモデル(model_not_found など)。error.param が該当フィールドを示します。 |
| 401 | キーがない、または無効・停止中(missing_api_key、invalid_api_key)。 |
| 402 | 残高不足、またはキーが予算の上限に達しました(insufficient_quota)。 |
| 403 | このキーのモデル許可リストにそのモデルが入っていないか、キーの IP 許可リストの外からのリクエストです(permission_denied)。 |
| 404 | パスが存在しないか、タスク ID が存在しない・3 日間の記録保存期間を過ぎた・別のアカウントが送信したタスクです(job_not_found)。 |
| 429 | このキーに設定した 1 分あたりの上限か無料モデルの 1 日の枠を超えたか、このモデルのすべての回線が混み合っています(rate_limit_exceeded)。Retry-After があればその秒数、なければ数秒待ってから再試行してください。 |
| 502 | 上流のエラーまたはタイムアウトで、回線を切り替えても失敗しました。理由は code(upstream_timeout、upstream_unavailable など)に入ります。課金されないので、そのまま再試行できます。 |
| 503 | モデルのメンテナンス中(model_maintenance)、または当サイト側の一時的なエラー(service_unavailable)です。課金されないので、しばらくして再試行してください。 |
思考モデルの max_tokens — Gemini 3.x Flash(3-flash-preview / 3.6 / 3.7 / 3.8 の全ティア)は、見える回答を書く前に隠れた推論で予算を使うため、予算が小さいと回答が始まる前に使い切ってしまいます。実測では max_tokens=16 はそのまま失敗し、32 / 64 は finish_reason=length とともに、もっともらしいが誤った値を返しました。ゲートウェイはこれらのモデルの出力予算を最低 512 まで引き上げます(課金は実際に使ったトークン分のみ)が、ご自身でも 512 以上を指定してください。finish_reason=length は途中で切れている可能性があるものとして扱い、max_tokens を増やして再試行してください。
接続、課金、モデル、安全性についてよくある質問。 NezhaGate よくある質問 →