リファレンスGPT Image 2.5 安定版

TopviewAI Pro Studio API ガイド

API キーの管理と、ログイン済み Studio のリクエストについて説明します。以下は GPT Image 2.5 の画像生成例です。他のモデルはそれぞれ異なる形式を使用します。

https://topviewai.pro
01

クイックスタート

生成タスクを送信し、ステータスをポーリングするだけの2ステップで、最初のAPI呼び出しを完了できます。

1

タスクを送信

POSTリクエストを generate エンドポイントに送信し、タスクIDを取得します。

2

ステータスを確認

タスクIDを使って進行状況を確認し、画像URLが返されるまでポーリングします。

02

認証

これらの Studio エンドポイントにはログイン済みセッションと API キーが必要です。Bearer キーのみでは利用できません。キーは公開しないでください。

HTTP ヘッダー
Authorization: Bearer {YOUR_API_KEY}
POST
https://topviewai.pro/api/image/gpt-image-2-5/generate

GPT Image 2.5 の画像リクエストを送信します。返された task_id を使い、対応する状態確認エンドポイントで結果を取得します。

非同期処理です。task_id を保存し、SUCCESS または終了を示すエラーになるまで状態を確認します。

リクエストボディのパラメータ

パラメータ名型必須説明
promptstring必須画像の説明を 1～20,000 文字で入力します。
aspect_ratiostringいいえ縦横比は任意で、既定値は auto です。例：1:1、4:3、3:4、16:9、9:16。
レスポンス(JSON)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}
GET
https://topviewai.pro/api/image/gpt-image-2-5/status

タスクの実行ステータスと結果を照会します。

クエリパラメータ

パラメータ名必須説明
task_id必須タスク送信時に返されるID。
レスポンス例
{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "山々に沈む夕日",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

課金

GPT Image 2.5 の費用例

4 クレジット / 1K 画像

消費量はモデル、解像度、設定によって変わります。Studio の見積もりとタスクに記録された消費量を確認してください。

エラー処理

  • 401 Unauthorized無効なAPIキー
  • 402 Payment Required残高不足
  • 429 Too Many Requestsレート制限に達しました
03

TopviewAI Pro について

動画、画像、編集、音声合成、オーディオを共通の Studio で利用できます。

作業ごとにモデルを選択

動画には Seedance 2.5、画像には GPT Image 2.5 など、Studio のモデルを選べます。各モデルは実名で表示します。

共通の残高、モデルごとの費用

サブスクリプションまたは都度の従量チャージを選べます。実際に使ったモデルやツールの料金をクレジットで支払います。

画像ツール動画ツール

© 2026 TopviewAI Pro.