メインコンテンツへスキップ

​
認証方法

すべての公開 API は、デフォルトで Bearer Token を使用します： 
Authorization: Bearer YOUR_API_KEY
ベース URL： 
https://api.aiid.edu.kg
一部のネイティブ形式またはモデル専用インターフェースはパスが異なりますが、API Key の認証方式は同じです。

​
エラー構造

失敗したリクエストを調査する際は、以下を優先的に確認してください：
  • HTTP ステータスコード
  • error.code
  • error.message
代表的な構造： 
{
  "error": {
    "code": "invalid_request_error",
    "message": "the reason why error occurred"
  }
}

​
主なステータスコード

HTTP意味推奨
400リクエストパラメータエラー必須フィールド、モデル名、パスパラメータを確認してください
401認証に失敗しましたAPI Key が有効か確認してください
404パスまたはタスクが存在しませんクエリパスとタスク ID を確認してください
429レート制限に到達リクエスト頻度を下げるか、再試行してください
500サーバーエラーリクエストを記録した上で再試行するか、サポートにお問い合わせください

​
一般的なステータス列挙値

一般的なロール (Role) 列挙値：
  • system
  • user
  • assistant
一般的な長時間タスクのステータス：
  • queued
  • running
  • succeeded
  • failed
  • in_progress
  • completed
ビデオ API によって返されるステータスフィールドは若干異なる場合がありますが、意味は「待機中 / 実行中 / 完了 / 失敗」を基本としています。

​
非同期タスクのクエリ

現在の公開ドキュメントは「タスク結果の能動的なクエリ」を主体としており、主な方法には以下が含まれます：
  • GET /v1/videos/{task_id}
  • GET /v1/responses/{response_id}
  • GET /api/v3/contents/generations/tasks/{task_id}
  • GET /suno/fetch/{task_id}
  • GET /ent/v2/tasks/{task_id}/creations
  • GET /v1beta/{operation_name}
実装側への推奨事項：
  • タスククエリに対して再試行とエクスポネンシャルバックオフを実施する
  • task_id または operation_name を永続化して保存する
  • 結果照会は、非同期タスクのポーリング（回查）におけるフォールバック手段として利用します