メインコンテンツへスキップ
AIReiter は統一された AI コンテンツ生成 API プラットフォームであり、画像および動画生成サービスを提供します。シンプルな REST API コールを通じて、GPT-4o、Gemini、Sora2、VEO3 などの主要な AI モデルを使用して高品質な画像や動画コンテンツを生成できます。

クイックスタート

API ワークフロー

1. 生成タスクの提出

すべての画像と動画の生成は非同期処理モードを採用しています。タスクを提出するときは out_task_id(発信側のタスクID)を渡す必要があり、システムは task_idout_task_id を返します:
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_4o",
    "params": {
      "prompt": "かわいい猫が庭にいる",
      "aspect_ratio": "1:1"
    },
    "out_task_id": "my_task_123456"
  }'

2. タスクステータスの照会

返却された task_id または提出した際の out_task_id を使用してタスクの進捗と結果を照会します(いずれか一方):
# task_id を使用して照会
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "task_id": "order_xxxxxxxxxxxx"
  }'

# または out_task_id を使用して照会
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "out_task_id": "my_task_123456"
  }'

3. 生成結果の取得

タスクが完了すると、レスポンスに生成された画像または動画のURLが含まれます:
{
  "statusCode": 200,
  "message": "",
  "data": {
    "task_id": "order_xxxxxxxxxxxx",
    "out_task_id": "my_task_123456",
    "status": "completed",
    "output": [
      {
        "url": "https://s1.pxz.ai/upload/image-generator/xxx.jpeg"
      }
    ]
  }
}

対応モデル

画像生成シリーズ

AIReiter は複数の画像生成モデルを提供しており、テキストから画像生成および画像から画像生成機能をサポートしています:

動画生成シリーズ

テキストから動画生成および画像から動画生成をサポートし、複数の解像度と長さのオプションを提供します:

コア機能

非同期タスク処理

すべての生成リクエストは非同期処理モードを採用し、長時間の待機を回避します:
  • タスクを送信する際、out_task_id(発行者側のタスクID、ビジネス識別用)を渡す必要があります
  • システムが生成したtask_idと送信したout_task_idを即座に返します
  • タスクの状態はtask_idまたはout_task_idで照会可能(どちらか一方)
  • webhookコールバック通知をサポート(任意)
  • タスクの状態はリアルタイムで更新:pendingprocessingcompleted

複数モデル対応

統一されたAPIエンドポイントで、複数の画像・動画生成モデルをサポート:
  • 画像生成:GPT-4o、Gemini、Seedreamなど5モデル
  • 動画生成:Sora2、VEO3など4モデル
  • 統一されたリクエスト形式とレスポンス構造
  • 柔軟なパラメータ設定

透明な料金設定

ポイント制で課金され、透明かつ明確です:
  • 各タスクに対して予想消費ポイントを返却
  • タスク完了後に実際の消費ポイントを表示
  • 成功した生成コンテンツのみ課金
  • 隠れた料金なし

柔軟な設定

複数の生成パラメータ設定をサポート:
  • 画像:複数のアスペクト比(1:1、3:2、2:3)
  • 動画:複数のアスペクト比(16:9、9:16)、長さ(10秒、15秒)、解像度
  • 参照画像のサポート(画像から画像、画像から動画)
  • カスタムメタデータ(metadata)

認証方法

すべての API リクエストは Bearer Token を使用した認証が必要です:
Authorization: Bearer YOUR_API_KEY
API キーの取得: API キー管理ページ にアクセスして、API キーを取得してください。

よくある質問

APIキー管理ページにアクセスし、ログインするとAPIキーを作成および管理できます。
すべての生成タスクは非同期処理されています。画像生成は通常数秒から数十秒かかり、動画生成は長さと解像度に応じて通常1~5分かかります。タスクを送信するとすぐにtask_idが返され、状態確認APIで進行状況を追跡できます。
タスク状態確認APIを使用し、送信時に返されたtask_idまたはお客様が設定したout_task_id(どちらか一方)を渡してください:
POST https://test.aireiter.com/api/openapi/query
詳細はタスク状態確認ドキュメントをご覧ください。
out_task_idは依頼者が設定するタスクIDで、タスク送信時にカスタム設定します:
  • 必須パラメータ:タスク送信時に必ずout_task_idを渡す必要があります
  • ビジネス識別:注文番号やビジネスIDなど、システム内の識別子として使用できます
  • 柔軟な検索:システムから返されるtask_idを保存しなくても、直接out_task_idでタスク状態を照会可能です
  • 結果の紐付け:照会結果にはtask_idout_task_idが共に返され、ビジネスデータの紐付けに便利です
はい、タスク送信時にcallback_urlパラメータを渡すことができます。タスク完了後、システムは該当URLへPOSTリクエストを送信し、完全なタスク結果を含みます。
AIReiterはポイント制料金を採用しています:
  • タスク送信時に見積もりポイント(estimated_credits)が返されます
  • タスク完了後に実消費ポイント(credits_used)が返されます
  • 成功した生成内容にのみ課金し、失敗タスクは課金されません
  • モデルによりポイント消費量が異なります
  • 画像:JPEG、PNGなど一般的な形式をサポート
  • 動画:出力フォーマットはMP4
  • 参考画像:入力は公開アクセス可能な画像URLをサポート

次のステップ