計劃額度支付完成但未即時更新

计划额度支付完成但未即时更新

Credits Paid But Balance Not Refreshed

決済完了後、残高が即座に反映されない

이용 한도 결제 완료 후 미동기화 현상

Баланс не обновился после успешной оплаты

問題分析：通常是由於第三方結算網關與平台主控台之間存在快取延遲所致，實際的 API 接口調用配額已在後台實時扣減並啟用。

问题分析：通常由于第三方结算网关与平台主控台之间存在缓存延迟所致，实际的 API 接口调用配额已在后台实时扣减并启用。

Analysis: Mostly caused by temporary cached delays between third-party billing webhooks and the database. Actual API quota is usually immediately effective.

問題分析: 決済システムとデータベース間のネットワーク遅延による一時的な同期ズレです。実際のAPI接続クォータはバックグラウンドですぐ有効化されます。

원인 분석: 결제 대행사와 데이터베이스 간 트랜잭션 수신 시 동기화 딜레이가 발생한 것이며, 실제 사용량 한도는 정상 반영된 상태입니다.

Причина: Обычно это связано с временной задержкой синхронизации платежного шлюза. Лимиты для использования API становятся активны практически мгновенно.

解決方案：

解决方案：

Solution:

解決策:

조치 방법:

Решение:

1. 您可前往主控台的「使用日誌」板塊，確認是否有對應交易成功的帳本記錄。
2. 若因異常網絡中斷或支付接口同步失敗，請透過商務聯絡郵箱或首頁的 WeChat 諮詢專員 進行人工校驗與補單。

1. 您可前往主控台的「使用日志」板块，确认是否有对应交易成功的账本记录。
2. 若因异常网络中断或支付接口同步失败，请通过商务联络邮箱或首页的 WeChat 咨询专员 进行人工校验与补单。

1. Go to "Usage Logs" in the developer console to verify the status of the purchase transaction.
2. In case of anomalous network dropouts, contact our Business Consultant (WeChat ID: linkapi) or email us for manual reconciliation.

1. 「接続ログ」ページで、該当するチャージ成功履歴が表示されているか確認します。
2. 通信遮断や一時的な不整合の場合は、WeChat担当者 またはメールサポートまでお気軽にお問い合わせください。

1. 관리 콘솔 내 '이용 로그' 메뉴로 이동하여 입금 및 변동 이력이 기록되었는지 우선 체크하세요.
2. 지속해서 표시 연동 오류가 유지될 경우, WeChat 비즈니스 담당자 혹은 이메일을 통해 보완 처리를 요구해 주세요.

1. Перейдите во вкладку «Логи расходов», чтобы проверить статус зачисления средств.
2. В случае сбоев обратитесь к нашему специалисту через WeChat (ID: linkapi) или по почте для ручного начисления.

Claude Code 上下文耗盡

Claude Code 上下文耗尽

Claude Code Context Exhausted

Claude Code のコンテキスト上限

Claude Code 컨텍스트 한도 초과

Контекст Claude Code исчерпан

問題描述：Claude Code 提示上下文窗口已滿，無法繼續對話。

问题描述：Claude Code 提示上下文窗口已满，无法继续对话。

Problem: Claude Code reports that the context window is full and cannot continue.

問題: Claude Code がコンテキストウィンドウ満杯を表示し、会話を続行できません。

문제: Claude Code에서 컨텍스트 창이 가득 찼다고 표시되어 대화를 이어갈 수 없습니다.

Проблема: Claude Code сообщает, что окно контекста заполнено.

/clear

在 Claude Code 中輸入 /clear 清除當前上下文，然後重新開始對話。處理大型專案時，建議分階段拆分任務，避免單次對話過長。

在 Claude Code 中输入 /clear 清除当前上下文，然后重新开始对话。处理大型项目时，建议分阶段拆分任务，避免单次对话过长。

Run /clear in Claude Code to clear the current context, then start a new conversation. For large projects, split work into stages to avoid oversized sessions.

Claude Code で /clear を実行して現在のコンテキストをクリアし、新しい会話を開始します。大規模プロジェクトでは作業を段階分けしてください。

Claude Code에서 /clear를 입력해 현재 컨텍스트를 비운 뒤 새 대화를 시작하세요. 큰 프로젝트는 단계별로 나누어 진행하는 것이 좋습니다.

Введите /clear в Claude Code, чтобы очистить текущий контекст и начать новый диалог. Для крупных проектов разбивайте работу на этапы.

金鑰複製不完整

金钥复制不完整

Token Copy Incomplete

キーが完全にコピーされない

키가 완전히 복사되지 않음

Токен скопирован не полностью

1. 點擊金鑰旁邊的「複製」圖示複製完整內容。
2. 手動選中從 sk- 開頭到結尾的完整字串。
3. 確認沒有多餘空格或換行後再貼入客戶端。

1. 点击金钥旁边的「复制」图标复制完整内容。
2. 手动选中从 sk- 开头到结尾的完整字符串。
3. 确认没有多余空格或换行后再粘贴到客户端。

1. Click the copy icon next to the token to copy the full value.
2. Manually select the full string from sk- to the end.
3. Ensure there are no extra spaces or line breaks before pasting it into a client.

1. キー横のコピーアイコンをクリックして全文をコピーします。
2. sk- から末尾までを手動で選択します。
3. 余分な空白や改行がないことを確認してから貼り付けます。

1. 키 옆의 복사 아이콘을 눌러 전체 문자열을 복사합니다.
2. sk-부터 끝까지 직접 선택합니다.
3. 불필요한 공백이나 줄바꿈이 없는지 확인한 뒤 클라이언트에 붙여넣습니다.

1. Нажмите значок копирования рядом с токеном, чтобы скопировать полное значение.
2. Выделите всю строку от sk- до конца.
3. Перед вставкой убедитесь, что нет лишних пробелов или переносов строк.

Node.js 安裝失敗

Node.js 安装失败

Node.js Installation Failed

Node.js のインストール失敗

Node.js 설치 실패

Ошибка установки Node.js

• 確認已安裝 Node.js 18 或更高版本。
• Windows 請以系統管理員身分開啟 PowerShell 或命令提示字元。
• 安裝後重新開啟終端，執行 node --version 與 npm --version 驗證。

• 确认已安装 Node.js 18 或更高版本。
• Windows 请以管理员身份打开 PowerShell 或命令提示符。
• 安装后重新打开终端，执行 node --version 与 npm --version 验证。

• Confirm that Node.js 18 or newer is installed.
• On Windows, run PowerShell or Command Prompt as Administrator.
• Reopen the terminal after installation and verify with node --version and npm --version.

• Node.js 18 以上がインストールされているか確認します。
• Windows では PowerShell またはコマンドプロンプトを管理者として実行します。
• インストール後にターミナルを開き直し、node --version と npm --version を確認します。

• Node.js 18 이상이 설치되어 있는지 확인합니다.
• Windows에서는 PowerShell 또는 명령 프롬프트를 관리자 권한으로 실행합니다.
• 설치 후 터미널을 다시 열고 node --version, npm --version으로 확인합니다.

• Проверьте, что установлен Node.js 18 или новее.
• В Windows запускайте PowerShell или Command Prompt от имени администратора.
• После установки откройте терминал заново и проверьте node --version и npm --version.

API 請求超時

API 请求超时

API Request Timeout

API リクエストのタイムアウト

API 요청 시간 초과

Тайм-аут API-запроса

• 嘗試切換接口地址：https://api.linkapi.ai、https://hk.linkapi.ai 或 https://jp.linkapi.ai。
• 檢查本地網絡代理、防火牆或 DNS 設定。
• 確認模型名稱填寫正確。

• 尝试切换接口地址：https://api.linkapi.ai、https://hk.linkapi.ai 或 https://jp.linkapi.ai。
• 检查本地网络代理、防火墙或 DNS 设置。
• 确认模型名称填写正确。

• Try another endpoint: https://api.linkapi.ai, https://hk.linkapi.ai, or https://jp.linkapi.ai.
• Check local proxy, firewall, or DNS settings.
• Confirm that the model name is correct.

• https://api.linkapi.ai、https://hk.linkapi.ai、https://jp.linkapi.ai のいずれかに切り替えて試します。
• ローカルのプロキシ、ファイアウォール、DNS 設定を確認します。
• モデル名が正しいか確認します。

• https://api.linkapi.ai, https://hk.linkapi.ai, https://jp.linkapi.ai 중 다른 엔드포인트를 시도합니다.
• 로컬 프록시, 방화벽, DNS 설정을 확인합니다.
• 모델 이름이 올바른지 확인합니다.

• Попробуйте другой адрес: https://api.linkapi.ai, https://hk.linkapi.ai или https://jp.linkapi.ai.
• Проверьте локальный прокси, firewall или DNS.
• Убедитесь, что имя модели указано правильно.

觸發後會看到什麼

触发后会看到什么

What You May See After a Safety Trigger

安全フィルター作動時の見え方

안전 필터가 작동하면 보이는 현상

Что происходит при safety trigger

• 直接拒答：模型回覆「我不能幫助這個請求」或改為安全建議。
• 空回或空白：有些客戶端只顯示空白消息、空輸出、無候選內容，實際也可能是安全過濾或候選內容被上游攔截。
• 輸出中斷：流式輸出到一半停止，後續沒有正常續寫。
• 候選內容被擋：Gemini 可能返回 finishReason: SAFETY、promptFeedback.blockReason 或 safety ratings。
• 錯誤碼：部分平台會返回 400、policy、safety、blocked、content_policy_violation 類錯誤。
• 答非所問：模型可能避開角色扮演細節，改成概括、道德提醒、風險說明。

• 直接拒答：模型回复“我不能帮助这个请求”或改为安全建议。
• 空回或空白：有些客户端只显示空白消息、空输出、无候选内容，实际也可能是安全过滤或候选内容被上游拦截。
• 输出中断：流式输出到一半停止，后续没有正常续写。
• 候选内容被挡：Gemini 可能返回 finishReason: SAFETY、promptFeedback.blockReason 或 safety ratings。
• 错误码：部分平台会返回 400、policy、safety、blocked、content_policy_violation 类错误。
• 答非所问：模型可能避开角色扮演细节，改成概括、道德提醒、风险说明。

• Direct refusal: The model says it cannot help, or redirects to safe advice.
• Empty response: Some clients only show a blank message, empty output, or no candidates. This can still be a safety filter or upstream candidate block.
• Interrupted output: Streaming may stop mid-generation without a normal continuation.
• Blocked candidates: Gemini may return finishReason: SAFETY, promptFeedback.blockReason, or safety ratings.
• Error codes: Some providers return 400, policy, safety, blocked, or content_policy_violation errors.
• Off-target answer: The model may avoid roleplay details and switch to summary, warning, or risk explanation.

• 直接拒否: モデルが支援できないと答える、または安全な助言に切り替えます。
• 空の応答: 一部のクライアントでは空メッセージ、空出力、候補なしとして表示されます。これも安全フィルターまたは上流の候補ブロックである場合があります。
• 出力中断: ストリーミングが途中で止まり、通常の続きが出ません。
• 候補ブロック: Gemini は finishReason: SAFETY、promptFeedback.blockReason、safety ratings を返す場合があります。
• エラーコード: 400、policy、safety、blocked、content_policy_violation 系のエラーになる場合があります。
• 意図と違う回答: ロールプレイの詳細を避け、要約、注意、リスク説明に変わる場合があります。

• 직접 거절: 모델이 도움을 줄 수 없다고 하거나 안전한 조언으로 전환합니다.
• 빈 응답: 일부 클라이언트는 빈 메시지, 빈 출력, 후보 없음으로만 표시합니다. 이 역시 안전 필터 또는 상위 후보 차단일 수 있습니다.
• 출력 중단: 스트리밍 출력이 중간에 멈추고 정상적으로 이어지지 않을 수 있습니다.
• 후보 차단: Gemini는 finishReason: SAFETY, promptFeedback.blockReason, safety ratings를 반환할 수 있습니다.
• 오류 코드: 일부 제공사는 400, policy, safety, blocked, content_policy_violation 오류를 반환할 수 있습니다.
• 의도와 다른 답변: 모델이 역할극 세부 묘사를 피하고 요약, 경고, 위험 설명으로 전환할 수 있습니다.

• Прямой refusal: Модель сообщает, что не может помочь, или переходит к safe advice.
• Пустой ответ: Некоторые клиенты показывают blank message, empty output или no candidates. Это тоже может быть safety filter или upstream candidate block.
• Остановка вывода: Streaming может остановиться на середине генерации без нормального продолжения.
• Blocked candidates: Gemini может вернуть finishReason: SAFETY, promptFeedback.blockReason или safety ratings.
• Коды ошибок: Некоторые providers возвращают 400, policy, safety, blocked или content_policy_violation.
• Ответ не по роли: Модель может избегать roleplay details и перейти к summary, warning или risk explanation.

為什麼被過濾依然會計費

为什么被过滤依然会计费

Why Safety-Filtered Requests Are Still Billed

安全フィルターでも課金される理由

안전 필터가 걸려도 과금되는 이유

Почему safety-filtered запросы тарифицируются

• 請求已被模型處理：官方模型需要讀取輸入、理解上下文、執行安全分類，這些都會消耗輸入 token。
• 拒答也可能生成輸出：拒絕語、風險提示、部分已生成內容都屬於輸出 token。
• 流式中斷前已產生成本：如果模型已經輸出了一部分再被截斷，已使用 token 仍會計入 usage。
• 官方返回 usage：例如 Anthropic 文檔說明拒絕仍會返回 usage；輸出 token 會按拒絕前已生成的內容計算。
• LinkAPI 按上游實際 usage 結算：只要上游官方返回用量或已消耗資源，平台就需要同步扣費。

• 请求已被模型处理：官方模型需要读取输入、理解上下文、执行安全分类，这些都会消耗输入 token。
• 拒答也可能生成输出：拒绝语、风险提示、部分已生成内容都属于输出 token。
• 流式中断前已产生成本：如果模型已经输出了一部分再被截断，已使用 token 仍会计入 usage。
• 官方返回 usage：例如 Anthropic 文档说明拒绝仍会返回 usage；输出 token 会按拒绝前已生成的内容计算。
• LinkAPI 按上游实际 usage 结算：只要上游官方返回用量或已消耗资源，平台就需要同步扣费。

• The model already processed the request: Reading input, understanding context, and running safety classification consume input tokens.
• Refusals can still generate output: Refusal text, warnings, and partial completions count as output tokens.
• Streaming may have already used tokens: If generation started before being stopped, generated tokens are still included in usage.
• Official APIs return usage: Anthropic documentation notes that refusals still return usage; output tokens are counted for content generated before refusal.
• LinkAPI follows upstream usage: When the upstream provider reports usage or consumes resources, the platform must settle that cost.

• リクエストは処理済み: 入力の読解、文脈理解、安全分類には入力tokenが使われます。
• 拒否にも出力がある: 拒否文、警告、一部生成済み内容は出力tokenです。
• ストリーミング中断前に消費済み: 途中まで生成されたtokenは usage に含まれます。
• 公式APIが usage を返す: Anthropic文書では拒否でも usage が返り、拒否前に生成された出力tokenが計算されます。
• LinkAPI は上流 usage に従う: 上流が使用量を返す、またはリソースを消費した場合、平台側もそのコストを反映します。

• 요청은 이미 처리됨: 입력 읽기, 문맥 이해, 안전 분류는 입력 token을 소비합니다.
• 거절도 출력일 수 있음: 거절 문구, 경고, 일부 생성 내용은 출력 token으로 계산됩니다.
• 스트리밍 중단 전 비용 발생: 일부 생성 후 중단되면 이미 생성된 token은 usage에 포함됩니다.
• 공식 API가 usage를 반환: Anthropic 문서는 거절에도 usage가 반환되며 거절 전 생성된 출력 token이 계산된다고 설명합니다.
• LinkAPI는 상위 provider usage를 따름: 상위 provider가 사용량을 반환하거나 리소스를 소비하면 플랫폼도 해당 비용을 정산해야 합니다.

• Запрос уже обработан: Чтение input, понимание context и safety classification расходуют input tokens.
• Refusal тоже может быть output: Текст отказа, warnings и частично сгенерированный контент считаются output tokens.
• Streaming уже мог потратить tokens: Если генерация началась до остановки, сгенерированные tokens входят в usage.
• Official APIs возвращают usage: Anthropic documentation указывает, что refusals still return usage; output tokens считаются за контент, созданный до refusal.
• LinkAPI следует upstream usage: Если upstream provider сообщает usage или расходует ресурсы, платформа должна учитывать этот cost.

角色扮演客戶應該怎麼做

角色扮演客户应该怎么做

What Roleplay Users Should Do

ロールプレイ利用者の対処方法

역할극 사용자가 해야 할 일

Что делать roleplay пользователям

• 先清理人設卡：刪除未成年人暗示、強迫、非自願、血腥虐待、違法細節、露骨性描寫、越獄提示。
• 改寫成合規創作：使用成年人、雙方自願、非露骨、非血腥、非違法、偏氛圍與情緒描寫的設定。
• 降低上下文風險：長對話累積敏感內容後更容易觸發，建議新開會話或摘要後重開。
• 不要反覆刷同一段：同一違規片段重試通常只會再次扣費並再次被拒。
• 把請求改成安全方向：例如「改寫為全年齡可讀版本」「保留緊張氛圍但不描寫傷害細節」「做風險審核」。
• 換模型不保證解除：不同模型安全閾值不同，但官方政策仍存在；被安全攔截不是平台可以手動放行的問題。

• 先清理人设卡：删除未成年人暗示、强迫、非自愿、血腥虐待、违法细节、露骨性描写、越狱提示。
• 改写成合规创作：使用成年人、双方自愿、非露骨、非血腥、非违法、偏氛围与情绪描写的设定。
• 降低上下文风险：长对话累积敏感内容后更容易触发，建议新开会话或摘要后重开。
• 不要反复刷同一段：同一违规片段重试通常只会再次扣费并再次被拒。
• 把请求改成安全方向：例如“改写为全年龄可读版本”“保留紧张氛围但不描写伤害细节”“做风险审核”。
• 换模型不保证解除：不同模型安全阈值不同，但官方政策仍存在；被安全拦截不是平台可以手动放行的问题。

• Clean character cards first: Remove minor-coded traits, coercion, non-consent, gore, abuse, illegal details, explicit sexual content, and jailbreak instructions.
• Rewrite as compliant fiction: Use adult characters, mutual consent, non-explicit language, non-gory scenes, lawful premises, and atmosphere/emotion-focused writing.
• Reduce context risk: Long chats can accumulate sensitive context. Start a new session or summarize safely before continuing.
• Do not spam the same blocked text: Retrying the same unsafe fragment usually causes another charge and another refusal.
• Redirect to safe tasks: Ask for an all-ages rewrite, tense atmosphere without harm details, or a risk review.
• Switching models is not a guarantee: Safety thresholds vary, but official policies still apply. A safety block cannot be manually bypassed by the platform.

• キャラクターカードを整理: 未成年を示唆する要素、強制、非同意、流血虐待、違法詳細、露骨な性的描写、脱獄指示を削除します。
• 合規創作に書き換える: 成人、双方同意、非露骨、非流血、合法設定、雰囲気と感情中心の描写にします。
• 文脈リスクを下げる: 長い会話では敏感内容が蓄積します。新しい会話を開始するか、安全に要約して続けます。
• 同じ文を繰り返さない: 同じブロック内容の再試行は、再課金と再拒否になりやすいです。
• 安全な依頼に変更: 「全年齢向けに書き換える」「傷害詳細なしで緊張感を保つ」「リスクレビューを行う」などにします。
• モデル変更は保証ではない: 閾値はモデルごとに違いますが、公式ポリシーは残ります。安全ブロックは平台側で手動解除できません。

• 캐릭터 카드 정리: 미성년 암시, 강제, 비동의, 유혈/학대, 불법 세부 정보, 노골적 성적 묘사, jailbreak 지시를 제거하세요.
• 준수 가능한 창작으로 수정: 성인 캐릭터, 상호 동의, 비노골적 표현, 비유혈 장면, 합법적 전제, 분위기와 감정 중심 묘사를 사용하세요.
• 문맥 위험 낮추기: 긴 대화는 민감한 문맥이 누적됩니다. 새 세션을 시작하거나 안전하게 요약한 뒤 이어가세요.
• 같은 차단 문구 반복 금지: 같은 위험 내용을 재시도하면 보통 다시 과금되고 다시 거절됩니다.
• 안전한 요청으로 전환: 전연령 버전으로 수정, 피해 세부 묘사 없는 긴장감 유지, 위험 검토 등을 요청하세요.
• 모델 변경은 보장 아님: 모델마다 임계값은 다르지만 공식 정책은 유지됩니다. 안전 차단은 플랫폼이 수동으로 우회할 수 없습니다.

• Очистите character cards: Уберите minor-coded traits, coercion, non-consent, gore, abuse, illegal details, explicit sexual content и jailbreak instructions.
• Перепишите как compliant fiction: Adult characters, mutual consent, non-explicit language, non-gory scenes, lawful premises и акцент на atmosphere/emotion.
• Снизьте context risk: Long chats накапливают sensitive context. Начните новую сессию или сделайте safe summary.
• Не повторяйте тот же blocked text: Повтор обычно приводит к новой тарификации и новому refusal.
• Переведите запрос в safe direction: All-ages rewrite, tense atmosphere without harm details, risk review.
• Смена модели не гарантирует результат: Safety thresholds различаются, но official policies остаются. Platform не может вручную bypass safety block.

400 快速定位總表

400 快速定位总表

400 Quick Triage Table

400エラー早見表

400 빠른 진단표

Быстрая диагностика 400

• invalid_request_error / BadRequestError：請求格式錯。檢查 URL、Header、JSON、模型名、字段名與參數範圍。
• invalid_api_key / authentication_error：Key 錯或 Header 放錯。確認完整複製 sk-，Claude Native 用 x-api-key，OpenAI 用 Authorization: Bearer。
• model_not_found / unknown model：模型名不可用或填錯。到模型價格頁複製完整模型名，不要自行簡寫。
• unsupported_parameter / unknown field：把某接口的字段傳給另一個接口。Responses、Chat Completions、Claude Messages、Gemini generateContent 字段不能混用。
• context_length_exceeded / input too long：上下文超限。縮短歷史對話、刪除大文件、降低輸入長度或新開會話。
• rate_limit_exceeded / quota：速率或額度不足。降低併發、等待重試、檢查餘額與配額。
• content_policy_violation / safety / blocked：安全策略攔截。處理方式請看上一節「安全過濾與角色扮演」。
• tool schema / invalid function：工具定義錯。確保工具名合法、JSON Schema 可解析、required 字段存在、參數類型一致。

• invalid_request_error / BadRequestError：请求格式错。检查 URL、Header、JSON、模型名、字段名与参数范围。
• invalid_api_key / authentication_error：Key 错或 Header 放错。确认完整复制 sk-，Claude Native 用 x-api-key，OpenAI 用 Authorization: Bearer。
• model_not_found / unknown model：模型名不可用或填错。到模型价格页复制完整模型名，不要自行简写。
• unsupported_parameter / unknown field：把某接口的字段传给另一个接口。Responses、Chat Completions、Claude Messages、Gemini generateContent 字段不能混用。
• context_length_exceeded / input too long：上下文超限。缩短历史对话、删除大文件、降低输入长度或新开会话。
• rate_limit_exceeded / quota：速率或额度不足。降低并发、等待重试、检查余额与配额。
• content_policy_violation / safety / blocked：安全策略拦截。处理方式请看上一节「安全过滤与角色扮演」。
• tool schema / invalid function：工具定义错。确保工具名合法、JSON Schema 可解析、required 字段存在、参数类型一致。

• invalid_request_error / BadRequestError: Request shape is invalid. Check URL, headers, JSON, model name, field names, and parameter ranges.
• invalid_api_key / authentication_error: Wrong key or wrong auth header. Copy the full sk- token; Claude Native uses x-api-key, while OpenAI uses Authorization: Bearer.
• model_not_found / unknown model: Model is unavailable or misspelled. Copy the exact model name from the pricing page.
• unsupported_parameter / unknown field: Fields from one API were sent to another API. Do not mix Responses, Chat Completions, Claude Messages, and Gemini generateContent schemas.
• context_length_exceeded / input too long: Context is too large. Shorten history, remove large files, reduce input, or start a new session.
• rate_limit_exceeded / quota: Rate or balance limit. Reduce concurrency, retry later, and check balance and quotas.
• content_policy_violation / safety / blocked: Safety policy block. See the previous Safety Filters & Roleplay section for handling guidance.
• tool schema / invalid function: Tool definition is invalid. Ensure legal tool names, valid JSON Schema, required fields, and matching parameter types.

• invalid_request_error / BadRequestError: リクエスト形式エラーです。URL、Header、JSON、モデル名、フィールド名、パラメータ範囲を確認します。
• invalid_api_key / authentication_error: Key または認証Headerが誤っています。sk- を完全にコピーし、Claude Native は x-api-key、OpenAI は Authorization: Bearer を使います。
• model_not_found / unknown model: モデル名が利用不可または誤記です。料金ページから正確なモデル名をコピーします。
• unsupported_parameter / unknown field: 別APIのフィールドを混在させています。Responses、Chat Completions、Claude Messages、Gemini generateContent のschemaを混用しないでください。
• context_length_exceeded / input too long: コンテキスト超過です。履歴を短くし、大きなファイルを削除し、入力を減らすか新しい会話を開始します。
• rate_limit_exceeded / quota: レートまたは残高制限です。同時実行を下げ、時間を置いて再試行し、残高とクォータを確認します。
• content_policy_violation / safety / blocked: 安全ポリシーブロックです。対処方法は前節の安全フィルターを参照してください。
• tool schema / invalid function: ツール定義エラーです。ツール名、JSON Schema、required、型の一致を確認します。

• invalid_request_error / BadRequestError: 요청 형식 오류입니다. URL, Header, JSON, 모델명, 필드명, 파라미터 범위를 확인하세요.
• invalid_api_key / authentication_error: Key 또는 인증 Header가 잘못되었습니다. sk- 키를 완전히 복사하고 Claude Native는 x-api-key, OpenAI는 Authorization: Bearer를 사용하세요.
• model_not_found / unknown model: 모델을 사용할 수 없거나 오타가 있습니다. 요금 페이지에서 정확한 모델명을 복사하세요.
• unsupported_parameter / unknown field: 다른 API의 필드를 섞었습니다. Responses, Chat Completions, Claude Messages, Gemini generateContent schema를 혼용하지 마세요.
• context_length_exceeded / input too long: 컨텍스트가 초과되었습니다. 대화 기록을 줄이고 큰 파일을 제거하거나 입력을 줄이고 새 세션을 시작하세요.
• rate_limit_exceeded / quota: 속도 또는 잔액 제한입니다. 동시 요청을 줄이고 나중에 재시도하며 잔액과 할당량을 확인하세요.
• content_policy_violation / safety / blocked: 안전 정책 차단입니다. 처리 방법은 이전 안전 필터 섹션을 참고하세요.
• tool schema / invalid function: 도구 정의 오류입니다. 도구명, JSON Schema, required 필드, 파라미터 타입 일치를 확인하세요.

• invalid_request_error / BadRequestError: Неверная форма запроса. Проверьте URL, headers, JSON, имя модели, поля и диапазоны параметров.
• invalid_api_key / authentication_error: Неверный ключ или auth header. Скопируйте полный sk- token; Claude Native использует x-api-key, OpenAI - Authorization: Bearer.
• model_not_found / unknown model: Модель недоступна или написана неверно. Скопируйте точное имя модели со страницы тарифов.
• unsupported_parameter / unknown field: Поля одного API отправлены в другой API. Не смешивайте схемы Responses, Chat Completions, Claude Messages и Gemini generateContent.
• context_length_exceeded / input too long: Контекст слишком большой. Сократите историю, удалите большие файлы, уменьшите input или начните новую сессию.
• rate_limit_exceeded / quota: Ограничение скорости или баланса. Уменьшите concurrency, повторите позже, проверьте баланс и квоты.
• content_policy_violation / safety / blocked: Блокировка safety policy. См. предыдущий раздел Safety filters.
• tool schema / invalid function: Неверное описание tool. Проверьте имена tools, JSON Schema, required fields и типы параметров.

Claude / Anthropic

• 官方 400 類型：Anthropic API 常見為 invalid_request_error，通常代表 JSON 結構、Header、模型名、參數範圍、工具定義或消息格式不符合要求。
• 安全相關返回：若錯誤文本包含 policy、safety、blocked，先按上一節安全過濾處理；若沒有安全提示，優先按請求格式錯誤排查。
• Agent 場景：工具調用請走 Claude Native 格式，保留 tools、tool_use、tool_result 的原生語義，避免 OpenAI 相容層轉換丟字段。
• 排查順序：檢查 anthropic-version、x-api-key、max_tokens、messages 是否正確，再確認模型名是否可用。
• 缺少版本 Header：若缺少 anthropic-version 或版本值錯誤，容易 400。Claude Native 示例固定帶 anthropic-version: 2023-06-01。
• max_tokens 缺失或超範圍：Claude Messages 通常要求 max_tokens，過大、為 0、非整數都可能被拒絕。
• 消息角色錯誤：messages 只放 user/assistant 對話；system 應放在頂層 system，不要塞進 messages。
• 圖片/文件格式錯：多模態內容需符合 Claude 原生 content block 結構，base64、media_type、source 字段缺一都可能 400。
• 工具結果順序錯：返回 tool_result 前必須有對應 tool_use id，id 不匹配或順序錯會被官方校驗拒絕。
• 採樣參數不兼容：部分 Claude 線路或工具場景對 top_p、temperature、stop_sequences 更嚴格，遇到 400 先刪除非必要採樣參數。

• 官方 400 类型：Anthropic API 常见为 invalid_request_error，通常代表 JSON 结构、Header、模型名、参数范围、工具定义或消息格式不符合要求。
• 安全相关返回：若错误文本包含 policy、safety、blocked，先按上一节安全过滤处理；若没有安全提示，优先按请求格式错误排查。
• Agent 场景：工具调用请走 Claude Native 格式，保留 tools、tool_use、tool_result 的原生语义，避免 OpenAI 兼容层转换丢字段。
• 排查顺序：检查 anthropic-version、x-api-key、max_tokens、messages 是否正确，再确认模型名是否可用。
• 缺少版本 Header：若缺少 anthropic-version 或版本值错误，容易 400。Claude Native 示例固定带 anthropic-version: 2023-06-01。
• max_tokens 缺失或超范围：Claude Messages 通常要求 max_tokens，过大、为 0、非整数都可能被拒绝。
• 消息角色错误：messages 只放 user/assistant 对话；system 应放在顶层 system，不要塞进 messages。
• 图片/文件格式错：多模态内容需符合 Claude 原生 content block 结构，base64、media_type、source 字段缺一都可能 400。
• 工具结果顺序错：返回 tool_result 前必须有对应 tool_use id，id 不匹配或顺序错会被官方校验拒绝。
• 采样参数不兼容：部分 Claude 线路或工具场景对 top_p、temperature、stop_sequences 更严格，遇到 400 先删除非必要采样参数。

• Official 400 type: Anthropic commonly returns invalid_request_error for invalid JSON schema, headers, model names, parameter ranges, tool definitions, or message formatting.
• Safety-related responses: If the error text contains policy, safety, or blocked, use the previous safety-filtering guidance. Otherwise, debug request format first.
• Agent workflows: Use Claude Native for tool calling so tools, tool_use, and tool_result keep their native semantics.
• Check order: Verify anthropic-version, x-api-key, max_tokens, and messages, then confirm that the model name is available.
• Missing version header: Missing or invalid anthropic-version often triggers 400. Use anthropic-version: 2023-06-01 for Claude Native examples.
• Missing or invalid max_tokens: Claude Messages usually requires max_tokens. Very large values, 0, or non-integers can be rejected.
• Wrong message roles: Put only user/assistant turns in messages. Put system instructions in the top-level system field.
• Invalid image/file blocks: Multimodal content must follow Claude native content block structure; missing base64, media_type, or source fields can cause 400.
• Tool result order mismatch: A tool_result must match a previous tool_use id. Missing ids or wrong ordering can fail validation.
• Sampling parameter incompatibility: Some Claude routes or tool workflows are stricter about top_p, temperature, or stop_sequences. Remove nonessential sampling parameters when debugging 400.

• 公式400タイプ: Anthropic API では invalid_request_error が一般的で、JSON構造、Header、モデル名、パラメータ範囲、ツール定義、メッセージ形式の不備を示します。
• 安全関連の返答: error に policy、safety、blocked が含まれる場合は前節の安全フィルターを参照します。それ以外はリクエスト形式を優先して確認します。
• Agent用途: ツール呼び出しでは Claude Native を使い、tools、tool_use、tool_result の意味を保持します。
• 確認順序: anthropic-version、x-api-key、max_tokens、messages を確認し、モデル名が利用可能か確認します。
• バージョンHeader不足: anthropic-version がない、または値が不正な場合は400になりやすいです。Claude Native では anthropic-version: 2023-06-01 を使います。
• max_tokens 不備: Claude Messages では通常 max_tokens が必要です。大きすぎる値、0、整数以外は拒否される場合があります。
• message roleの誤り: messages には user/assistant のみを入れ、system はトップレベルの system に置きます。
• 画像/ファイル形式エラー: マルチモーダル入力は Claude ネイティブcontent block構造に従う必要があり、base64、media_type、source 不足で400になる場合があります。
• tool_result順序エラー: tool_result は先行する tool_use id と対応する必要があります。id不一致や順序ミスは検証エラーになります。
• サンプリングパラメータ不一致: 一部のClaude経路やツール用途では top_p、temperature、stop_sequences が厳格です。400時は不要な生成パラメータを削除します。

• 공식 400 유형: Anthropic API는 잘못된 JSON 구조, Header, 모델명, 파라미터 범위, 도구 정의, 메시지 형식에 대해 주로 invalid_request_error를 반환합니다.
• 안전 관련 응답: 오류에 policy, safety, blocked가 포함되면 이전 안전 필터 안내를 따르세요. 그렇지 않으면 요청 형식을 먼저 디버깅하세요.
• Agent 작업: 도구 호출은 Claude Native 형식을 사용해 tools, tool_use, tool_result 의미를 유지하세요.
• 확인 순서: anthropic-version, x-api-key, max_tokens, messages를 확인한 뒤 모델명을 확인하세요.
• 버전 Header 누락: anthropic-version이 없거나 값이 잘못되면 400이 발생하기 쉽습니다. Claude Native 예시는 anthropic-version: 2023-06-01을 사용합니다.
• max_tokens 누락 또는 범위 오류: Claude Messages는 보통 max_tokens가 필요합니다. 너무 큰 값, 0, 정수가 아닌 값은 거부될 수 있습니다.
• 메시지 role 오류: messages에는 user/assistant만 넣고 system 지시는 최상위 system 필드에 넣으세요.
• 이미지/파일 형식 오류: 멀티모달 입력은 Claude 네이티브 content block 구조를 따라야 하며 base64, media_type, source 누락은 400을 유발할 수 있습니다.
• tool_result 순서 오류: tool_result는 이전 tool_use id와 매칭되어야 합니다. id 불일치나 순서 오류는 검증 실패가 됩니다.
• 샘플링 파라미터 불일치: 일부 Claude 경로나 도구 작업은 top_p, temperature, stop_sequences에 엄격합니다. 400 디버깅 시 불필요한 생성 파라미터를 제거하세요.

• Официальный тип 400: Anthropic часто возвращает invalid_request_error при неверной JSON-схеме, headers, имени модели, диапазоне параметров, tool definitions или формате messages.
• Safety-related responses: Если error содержит policy, safety или blocked, используйте предыдущий раздел safety filtering. Иначе сначала проверяйте request format.
• Agent: Для tool calling используйте Claude Native, чтобы сохранить семантику tools, tool_use и tool_result.
• Проверка: Проверьте anthropic-version, x-api-key, max_tokens, messages, затем доступность модели.
• Нет version header: Отсутствующий или неверный anthropic-version часто вызывает 400. Для Claude Native используйте anthropic-version: 2023-06-01.
• Неверный max_tokens: Claude Messages обычно требует max_tokens. Слишком большие значения, 0 или нецелые числа могут быть отклонены.
• Неверные message roles: В messages помещайте только user/assistant, а system instructions - в верхний system.
• Неверные image/file blocks: Multimodal content должен соответствовать Claude native content blocks; отсутствие base64, media_type или source может вызвать 400.
• Неверный порядок tool_result: tool_result должен соответствовать предыдущему tool_use id. Несовпадение id или порядок вызывает validation error.
• Несовместимые sampling parameters: Некоторые Claude routes или tool workflows строже проверяют top_p, temperature, stop_sequences. При 400 удалите необязательные sampling parameters.

OpenAI

• 官方 400 類型：常見原因包括 invalid_request_error、模型名不存在、字段不被當前接口支持、JSON 不合法、上下文超限或工具 schema 不符合 JSON Schema。
• 安全相關返回：若返回 safety / policy 相關錯誤，這不是普通 400 格式問題，請按上一節安全過濾處理。
• Responses API：Agent、工具調用、文件與多模態場景優先使用 /v1/responses，不要把 Responses 的字段硬塞到 Chat Completions。
• 排查順序：確認 Authorization、Content-Type、model、input 或 messages 字段，再檢查工具 schema 和上下文長度。
• messages / input 混用：Responses API 用 input，Chat Completions 用 messages。混用會導致 400 或字段無效。
• 工具 schema 不合法：函數名不能包含非法字符，parameters 必須是合法 JSON Schema；required 中列出的字段必須在 properties 中存在。
• JSON mode / structured output 錯誤：要求 JSON 輸出時，schema 必須可解析；不要要求模型輸出與 schema 衝突的格式。
• 圖片或文件輸入錯誤：多模態字段要符合當前接口格式；不要把文件 URL、base64 或 file_id 放到不支持該字段的接口。
• 流式參數錯誤：部分 SDK 的 stream_options、include、modalities 只在特定接口支持；400 時先移除高級可選字段，只保留最小請求。
• 安全攔截處理：若錯誤文本包含 policy、safety、disallowed、blocked，請按上一節安全過濾處理，不要當作普通格式錯誤。

• 官方 400 类型：常见原因包括 invalid_request_error、模型名不存在、字段不被当前接口支持、JSON 不合法、上下文超限或工具 schema 不符合 JSON Schema。
• 安全相关返回：若返回 safety / policy 相关错误，这不是普通 400 格式问题，请按上一节安全过滤处理。
• Responses API：Agent、工具调用、文件与多模态场景优先使用 /v1/responses，不要把 Responses 的字段硬塞到 Chat Completions。
• 排查顺序：确认 Authorization、Content-Type、model、input 或 messages 字段，再检查工具 schema 和上下文长度。
• messages / input 混用：Responses API 用 input，Chat Completions 用 messages。混用会导致 400 或字段无效。
• 工具 schema 不合法：函数名不能包含非法字符，parameters 必须是合法 JSON Schema；required 中列出的字段必须在 properties 中存在。
• JSON mode / structured output 错误：要求 JSON 输出时，schema 必须可解析；不要要求模型输出与 schema 冲突的格式。
• 图片或文件输入错误：多模态字段要符合当前接口格式；不要把文件 URL、base64 或 file_id 放到不支持该字段的接口。
• 流式参数错误：部分 SDK 的 stream_options、include、modalities 只在特定接口支持；400 时先移除高级可选字段，只保留最小请求。
• 安全拦截处理：若错误文本包含 policy、safety、disallowed、blocked，请按上一节安全过滤处理，不要当作普通格式错误。

• Official 400 causes: Common causes include invalid_request_error, unknown model names, unsupported fields for the chosen endpoint, invalid JSON, context overflow, or tool schemas that do not satisfy JSON Schema.
• Safety-related responses: If the error references safety or policy, this is not a normal schema 400. Use the safety-filtering guidance above.
• Responses API: Prefer /v1/responses for agents, tool calling, files, and multimodal workflows. Do not mix Responses-only fields into Chat Completions.
• Check order: Verify Authorization, Content-Type, model, input or messages, then validate tool schemas and context length.
• messages / input mix-up: Responses API uses input; Chat Completions uses messages. Mixing them can cause 400 or ignored fields.
• Invalid tool schema: Function names must be valid, parameters must be valid JSON Schema, and every field in required must exist in properties.
• JSON mode / structured output errors: Schemas must be parseable, and the prompt should not request output that conflicts with the schema.
• Image or file input errors: Multimodal fields must match the selected endpoint. Do not put file URLs, base64, or file_id values into endpoints that do not support them.
• Streaming option errors: Some SDK fields such as stream_options, include, or modalities are endpoint-specific. When debugging 400, remove advanced optional fields and retry a minimal request.
• Safety block handling: If the error text includes policy, safety, disallowed, or blocked, follow the safety-filtering section above instead of treating it as a normal schema error.

• 公式400原因: invalid_request_error、存在しないモデル名、エンドポイント非対応フィールド、不正JSON、コンテキスト超過、JSON Schemaに合わないツールschemaが主な原因です。
• 安全関連の返答: safety / policy 関連エラーは通常のschema 400ではありません。前節の安全フィルターを参照してください。
• Responses API: Agent、ツール呼び出し、ファイル、マルチモーダル用途では /v1/responses を優先します。Responses専用フィールドを Chat Completions に混在させないでください。
• 確認順序: Authorization、Content-Type、model、input または messages、tool schema、コンテキスト長を確認します。
• messages / input 混在: Responses API は input、Chat Completions は messages を使います。混在すると400や無効フィールドになります。
• tool schema不正: 関数名は有効で、parameters は有効な JSON Schema、required の各項目は properties に存在する必要があります。
• JSON mode / structured outputエラー: schema は解析可能である必要があり、プロンプトがschemaと矛盾する出力を要求してはいけません。
• 画像/ファイル入力エラー: マルチモーダルフィールドはエンドポイント形式に合わせます。非対応エンドポイントに file URL、base64、file_id を入れないでください。
• streaming optionエラー: stream_options、include、modalities は特定API専用の場合があります。400時は高度な任意フィールドを外して最小リクエストで確認します。
• 安全ブロック対応: policy、safety、disallowed、blocked を含む場合、通常の形式エラーではなく前節の安全フィルターとして扱います。

• 공식 400 원인: invalid_request_error, 존재하지 않는 모델명, 현재 엔드포인트에서 지원하지 않는 필드, 잘못된 JSON, 컨텍스트 초과, JSON Schema에 맞지 않는 도구 schema가 흔한 원인입니다.
• 안전 관련 응답: safety / policy 관련 오류는 일반 schema 400이 아닙니다. 위 안전 필터 안내를 따르세요.
• Responses API: Agent, 도구 호출, 파일, 멀티모달 작업은 /v1/responses를 우선 사용하세요. Responses 전용 필드를 Chat Completions에 섞지 마세요.
• 확인 순서: Authorization, Content-Type, model, input 또는 messages, 도구 schema, 컨텍스트 길이를 확인하세요.
• messages / input 혼용: Responses API는 input, Chat Completions는 messages를 사용합니다. 혼용하면 400 또는 필드 무시가 발생할 수 있습니다.
• 잘못된 도구 schema: 함수명은 유효해야 하고 parameters는 올바른 JSON Schema여야 하며 required 필드는 properties에 존재해야 합니다.
• JSON mode / structured output 오류: schema는 파싱 가능해야 하며 프롬프트가 schema와 충돌하는 출력을 요구하면 안 됩니다.
• 이미지/파일 입력 오류: 멀티모달 필드는 선택한 엔드포인트 형식과 일치해야 합니다. 지원하지 않는 엔드포인트에 file URL, base64, file_id를 넣지 마세요.
• 스트리밍 옵션 오류: stream_options, include, modalities 같은 SDK 필드는 특정 엔드포인트 전용일 수 있습니다. 400 디버깅 시 고급 선택 필드를 제거하고 최소 요청으로 재시도하세요.
• 안전 차단 처리: 오류에 policy, safety, disallowed, blocked가 있으면 일반 형식 오류가 아니라 위 안전 필터 섹션에 따라 처리하세요.

• Официальные причины 400: invalid_request_error, неизвестная модель, неподдерживаемые поля endpoint, некорректный JSON, превышение контекста или tool schema, не соответствующая JSON Schema.
• Safety-related responses: Ошибка safety / policy не является обычной schema 400. Используйте раздел safety filtering выше.
• Responses API: Для agents, tool calling, файлов и multimodal используйте /v1/responses. Не смешивайте поля Responses с Chat Completions.
• Проверка: Проверьте Authorization, Content-Type, model, input или messages, затем tool schemas и длину контекста.
• Смешивание messages / input: Responses API использует input, Chat Completions - messages. Смешивание может вызвать 400 или игнорирование полей.
• Неверная tool schema: Имена функций должны быть валидными, parameters - valid JSON Schema, а все поля из required должны быть в properties.
• JSON mode / structured output: Schema должна быть parseable, а prompt не должен требовать output, конфликтующий со schema.
• Ошибки image/file input: Multimodal fields должны соответствовать endpoint. Не отправляйте file URLs, base64 или file_id в endpoint, который их не поддерживает.
• Streaming options: stream_options, include, modalities могут поддерживаться только отдельными endpoint. При 400 удалите advanced optional fields и проверьте minimal request.
• Safety block: Если error содержит policy, safety, disallowed или blocked, обрабатывайте это как safety filtering выше, а не как обычную schema error.

Gemini / Google AI

• 官方 400 類型：Gemini 常見為 INVALID_ARGUMENT，通常代表模型名、URL 路徑、JSON 結構、contents、parts、工具聲明或 safety settings 不合法。
• 安全處理：Gemini 可能在候選結果中返回 finishReason: SAFETY 或 safety ratings。這代表內容被安全分類攔截，不應當作普通網絡錯誤重試。
• 工具調用：使用 Gemini Native 時，保留 functionDeclarations、functionCall、functionResponse 的原生結構，避免通過 OpenAI 相容層轉換。
• 排查順序：確認 URL 形如 /v1beta/models/{model}:generateContent，再檢查 key、contents、parts、模型名與 safety settings。
• URL 路徑錯誤：generateContent、streamGenerateContent、模型列表接口路徑不同；把 OpenAI /chat/completions 發到 Gemini 會 400/404。
• contents 結構錯：contents 應是數組，內容包含 role 和 parts；文本需放入 parts[].text。
• 多模態 parts 錯：圖片、音頻、文件要按 Gemini 原生 inline_data 或 file_data 結構傳，不要混用 OpenAI image_url 格式。
• safety settings 錯：安全分類與閾值名稱必須合法；調低閾值不代表可繞過官方政策，仍可能返回 SAFETY。
• 候選結果為空：若響應包含 promptFeedback 或 finishReason SAFETY，通常是安全攔截；應修改內容而不是重試同一請求。
• 工具聲明錯：functionDeclarations 的 name、description、parameters 必須符合 Gemini schema；函數響應需與先前 functionCall 名稱對應。

• 官方 400 类型：Gemini 常见为 INVALID_ARGUMENT，通常代表模型名、URL 路径、JSON 结构、contents、parts、工具声明或 safety settings 不合法。
• 安全处理：Gemini 可能在候选结果中返回 finishReason: SAFETY 或 safety ratings。这代表内容被安全分类拦截，不应当作普通网络错误重试。
• 工具调用：使用 Gemini Native 时，保留 functionDeclarations、functionCall、functionResponse 的原生结构，避免通过 OpenAI 兼容层转换。
• 排查顺序：确认 URL 形如 /v1beta/models/{model}:generateContent，再检查 key、contents、parts、模型名与 safety settings。
• URL 路径错误：generateContent、streamGenerateContent、模型列表接口路径不同；把 OpenAI /chat/completions 发到 Gemini 会 400/404。
• contents 结构错：contents 应是数组，内容包含 role 和 parts；文本需放入 parts[].text。
• 多模态 parts 错：图片、音频、文件要按 Gemini 原生 inline_data 或 file_data 结构传，不要混用 OpenAI image_url 格式。
• safety settings 错：安全分类与阈值名称必须合法；调低阈值不代表可绕过官方政策，仍可能返回 SAFETY。
• 候选结果为空：若响应包含 promptFeedback 或 finishReason SAFETY，通常是安全拦截；应修改内容而不是重试同一请求。
• 工具声明错：functionDeclarations 的 name、description、parameters 必须符合 Gemini schema；函数响应需与先前 functionCall 名称对应。

• Official 400 type: Gemini commonly returns INVALID_ARGUMENT when the model name, URL path, JSON structure, contents, parts, tool declarations, or safety settings are invalid.
• Safety handling: Gemini may return finishReason: SAFETY or safety ratings in candidates. Treat this as a policy block, not a normal network retry condition.
• Tool calling: With Gemini Native, keep functionDeclarations, functionCall, and functionResponse in their native structure instead of translating through OpenAI-compatible mode.
• Check order: Confirm the URL matches /v1beta/models/{model}:generateContent, then verify key, contents, parts, model name, and safety settings.
• Wrong URL path: generateContent, streamGenerateContent, and model-list endpoints are different. Sending OpenAI /chat/completions traffic to Gemini will fail.
• Invalid contents structure: contents should be an array with role and parts; text belongs in parts[].text.
• Invalid multimodal parts: Images, audio, and files must use Gemini native inline_data or file_data structures. Do not use OpenAI image_url format.
• Invalid safety settings: Safety category and threshold names must be valid. Lowering thresholds does not bypass official policy; SAFETY can still be returned.
• Empty candidates: If the response includes promptFeedback or finishReason SAFETY, it is usually a safety block; modify the content instead of retrying the same request.
• Invalid tool declarations: functionDeclarations name, description, and parameters must match Gemini schema, and function responses must correspond to a previous functionCall.

• 公式400タイプ: Gemini では INVALID_ARGUMENT が一般的で、モデル名、URLパス、JSON構造、contents、parts、ツール宣言、safety settings の不備を示します。
• 安全対応: Gemini は候補結果に finishReason: SAFETY または safety ratings を返す場合があります。通常のネットワークリトライではなく、ポリシーブロックとして扱います。
• ツール呼び出し: Gemini Native では functionDeclarations、functionCall、functionResponse のネイティブ構造を保持します。
• 確認順序: URL が /v1beta/models/{model}:generateContent 形式か確認し、key、contents、parts、モデル名、safety settings を確認します。
• URLパスエラー: generateContent、streamGenerateContent、モデル一覧は別パスです。OpenAI の /chat/completions を Gemini に送ると失敗します。
• contents 構造エラー: contents は配列で、role と parts を含みます。テキストは parts[].text に入れます。
• マルチモーダルpartsエラー: 画像、音声、ファイルは Gemini ネイティブの inline_data または file_data を使います。OpenAI image_url 形式を混用しないでください。
• safety settingsエラー: safety category と threshold 名は正確である必要があります。閾値を下げても公式ポリシーは回避できず、SAFETY が返る場合があります。
• 候補結果が空: promptFeedback または finishReason SAFETY がある場合、通常は安全ブロックです。同じ内容を再試行せず修正します。
• ツール宣言エラー: functionDeclarations の name、description、parameters は Gemini schema に従い、function response は先行する functionCall に対応する必要があります。

• 공식 400 유형: Gemini는 모델명, URL 경로, JSON 구조, contents, parts, 도구 선언, safety settings가 잘못되면 주로 INVALID_ARGUMENT를 반환합니다.
• 안전 처리: Gemini는 후보 결과에 finishReason: SAFETY 또는 safety ratings를 반환할 수 있습니다. 일반 네트워크 오류로 재시도하지 말고 정책 차단으로 처리하세요.
• 도구 호출: Gemini Native에서는 functionDeclarations, functionCall, functionResponse의 네이티브 구조를 유지하세요.
• 확인 순서: URL이 /v1beta/models/{model}:generateContent 형식인지 확인하고 key, contents, parts, 모델명, safety settings를 확인하세요.
• URL 경로 오류: generateContent, streamGenerateContent, 모델 목록 엔드포인트는 서로 다릅니다. OpenAI /chat/completions 요청을 Gemini로 보내면 실패합니다.
• contents 구조 오류: contents는 배열이어야 하며 role과 parts를 포함합니다. 텍스트는 parts[].text에 넣으세요.
• 멀티모달 parts 오류: 이미지, 오디오, 파일은 Gemini 네이티브 inline_data 또는 file_data 구조를 사용해야 합니다. OpenAI image_url 형식을 섞지 마세요.
• safety settings 오류: 안전 카테고리와 임계값 이름은 유효해야 합니다. 임계값을 낮춰도 공식 정책을 우회할 수 없으며 SAFETY가 반환될 수 있습니다.
• 후보 결과 없음: 응답에 promptFeedback 또는 finishReason SAFETY가 있으면 보통 안전 차단입니다. 같은 요청을 재시도하지 말고 내용을 수정하세요.
• 도구 선언 오류: functionDeclarations의 name, description, parameters는 Gemini schema를 따라야 하며 function response는 이전 functionCall과 대응해야 합니다.

• Официальный тип 400: Gemini часто возвращает INVALID_ARGUMENT при неверной модели, URL path, JSON-структуре, contents, parts, tool declarations или safety settings.
• Safety: Gemini может вернуть finishReason: SAFETY или safety ratings. Это policy block, а не обычная сетевая ошибка для повторной отправки.
• Tool calling: В Gemini Native сохраняйте нативные functionDeclarations, functionCall, functionResponse, не переводите через OpenAI-compatible слой.
• Проверка: URL должен соответствовать /v1beta/models/{model}:generateContent; затем проверьте key, contents, parts, модель и safety settings.
• Неверный URL path: generateContent, streamGenerateContent и model list endpoints различаются. Запрос OpenAI /chat/completions в Gemini завершится ошибкой.
• Неверная структура contents: contents должен быть массивом с role и parts; текст помещается в parts[].text.
• Неверные multimodal parts: Images, audio и files должны использовать Gemini native inline_data или file_data. Не используйте OpenAI image_url format.
• Неверные safety settings: Safety categories и thresholds должны быть валидными. Снижение threshold не обходит official policy; SAFETY все равно может вернуться.
• Пустые candidates: Если response содержит promptFeedback или finishReason SAFETY, это обычно safety block; измените content вместо повторной отправки.
• Неверные tool declarations: functionDeclarations name, description и parameters должны соответствовать Gemini schema, а function response должен соответствовать предыдущему functionCall.