Pro API: 制限、エラーコード、ベストプラクティス

上限

すべてのキーには3つの上限があります。同時レンダリング数（デフォルト2件）、1分あたりのリクエスト数（デフォルト60件）、そして設定した場合の1日のクレジット上限です。

上限を超えると 429 が返され、秒単位の Retry-After ヘッダーが付きます。拒否されたリクエストはクレジットを消費しません。 上限の「1日」はUTC基準です。

tendre.AIのカードはアプリのユーザーと共有されています。混雑時には、レンダリングが同じ価格・同じAPIで別途レンタルしたGPUに振り分けられますが、起動時に数十秒ほど余分にかかる場合があります。

エラーコード

コード	error	意味と対処法
400	champ prompt requis	プロンプトを追加してください。
400	contenu_interdit	コンテンツフィルターがプロンプトを拒否しました。
400	image_requise、inpaint_images_requises	このモードには image_b64 が必要です。inpaint の場合は mask_b64 も必要です。
401	cle_requise、cle_invalide	ヘッダーがないか、キーが不明です。
402	credits_insuffisants	このレンダリングに必要な残高が不足しています（cost に金額が示されます）。サイトでチャージしてください。
403	cle_desactivee、cle_revoquee、cle_expiree	キーが無効化、失効、または期限切れです。アプリで新しいキーを作成してください。
403	licence_revoquee、licence_non_pro	ライセンスが失効しているか、Proアカウントではありません。
403	portee_manquante	キーに必要な権限がありません。portee に権限名が示されます。
403	lora_inconnu	そのアカウントに属していないキャラクターです。
404	media_indisponible	ファイルが見つかりません。再送信してください。
413	image_trop_lourde	ソース画像またはマスクのデコード後サイズが12MBを超えています。
429	trop_de_rendus_simultanes、cadence_minute、plafond_jour	上限に達しました。Retry-After を確認してください。
429	plafond_credits_jour	キーの1日のクレジット上限に達しました（plafond、depense、cout を参照）。
502	soumission_echouee、statut_echoue	レンダリング側で障害が発生しました。数秒後に再試行してください。
503	licence_inverifiable	現在アカウントを確認できません。1分後に再試行してください。

エラー名はAPIが返す正確な文字列です。message の内容は変更される可能性があるため、エラー名でマッチングしてください。

ベストプラクティス

• ポーリングは3秒ごとに行ってください。それより短い間隔は避けてください。 キューは共有されており、過剰なリクエストは誰にとっても迷惑です。
• ステータスが completed になったらすぐにダウンロードしてください。 ファイルはアーカイブされません。
• プロンプトは英語で書いてください。 動画の場合は静止した状態ではなく動きを描写してください。
• 用途ごとにキーを分け、サーバーで使用するキーにはすべて1日のクレジット上限を設定してください。 上限付きのキーが漏洩しても、損失は1日分のみで済みます。
• 429 は異常ではなく通常の動作として扱ってください。 Retry-After の時間待ってから処理を続けてください。

プロンプトは、アプリと同様に、安全管理のためtendre.AI側でログに記録されます。