エラーと対処

Echo の API は、リクエストを処理できなかったとき、HTTP ステータス（結果を表す 3 桁の番号）と JSON のエラー本文を返します。

まず確かめること

1. 接続先 URL：OpenAI 形式は https://token.echohub.io/v1、Anthropic 形式は https://token.echohub.io です。呼び出し先のパスに /v1 がないと、キーが正しくても 404 になります（JSON ではなく、Web サイトの HTML ページが返ります）
2. API キー：コンソールの「APIキー」で、停止していないか、利用上限が残っているかを確認します
3. 残高：コンソールの「残高とチャージ」で確認します
4. モデル ID：モデル一覧の ID と一致しているかを確認します

エラー本文の形式

呼び出したエンドポイントの形式に合わせて、2 つの形式で返します。

Anthropic 形式の例（キーが違うとき）：

{"type":"error","error":{"type":"authentication_error","message":"Invalid API key"}}

OpenAI 形式の例（残高が足りないとき）：

{"error":{"message":"Insufficient balance","type":"api_error","param":"","code":"insufficient_quota"}}

• エラーの種類は、HTTP ステータスと、error.type（Anthropic 形式）または error.code（OpenAI 形式）で判断してください。message の文言は変わることがあるため、プログラムの分岐には使わないでください
• 経由先の API（モデルを実際に動かしている各社の API）が返したエラーは、message に経由先の文言をそのまま入れることがあります
• 項目の並び順は、エラーによって異なります

OpenAI 形式の error.type は、Echo が返すエラーでは主に api_error です。経由先のエラーをそのまま返す場合は、経由先の値が入ります。動画生成のエンドポイント（/v1/videos）では、error.type は HTTP ステータスに合わせた値です（400 は invalid_request_error、401 は authentication_error、403 は permission_error、404 と 410 は not_found_error、500 以上は api_error）。

状況ごとの原因と対処

動画生成のエラー

動画生成（/v1/videos）に特有のエラーです。手順と、モデルごとに使える値は動画生成にあります。

申し込みの時点で返したエラーに、料金はかかりません。生成に失敗したタスクは、進み具合を確かめると status が failed になっていて、料金は全額返金しています。

再試行するエラー

• 待ち時間を少しずつ延ばしながら、回数の上限を決めて再試行します
• Retry-After ヘッダーが付いている場合は、その秒数以上待ちます。アカウントのレート制限と経由先の API のレート制限による 429 には Retry-After: 60、接続元の IP アドレスごとの制限による 429 には待つ秒数、503 には Retry-After: 5 が付きます（経由先の API 側で Echo のアカウントに問題があるときの 503 は Retry-After: 60 のことがあります）
• モデル ID の誤りも 503 で返ります。OpenAI 形式では error.code が model_not_found になります。Anthropic 形式では message に does not exist or is not available が入ります
• OpenAI と Anthropic の SDK は、429 と 500 以上のエラーを既定で 2 回まで自動で再試行します。モデル ID の誤りでも 2 回再試行してからエラーになります。Claude Code は 1 分以上再試行を続けます（Claude Code）

ストリーミングの途中で止まったとき

ストリーミング（回答を少しずつ受け取る方法）では、最初に HTTP 200 を返してから回答を送ります。そのあとで経由先の API がエラーを返したり、接続が切れたりすると、次のように届きます（2026-09-27 時点。修正予定：[ ]）。

最後まで届いていない場合は、同じリクエストをもう一度送ってください。接続が切れた場合も、切れるまでに生成された分の料金がかかります（料金とチャージ）。

問い合わせるとき

Echo の API が処理した応答には、成功・失敗にかかわらず、リクエスト ID（1 回の呼び出しを見分ける番号）が付きます。レスポンスヘッダーの X-Request-Id と request-id に同じ値が入ります。

次の情報を添えて、https://echohub.io/contact から問い合わせてください。問い合わせフォームは Echo AI Hub のページで、会員サイトの公開後に使えます。

• エラーが起きた日時（日本時間）
• リクエスト ID
• 使ったモデル ID と、エンドポイントのパス
• キーの名前（キーそのものは送らないでください）
• HTTP ステータスとエラー本文

確認した情報源