AI画像生成APIドキュメント (v1)

このエンドポイントは安全なプロキシゲートウェイを提供し、基盤となるサービスプロバイダーの認証情報を公開することなく、AI画像生成モデルをトリガーすることを可能にします。

1. 概要

Endpoint URL

https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image

Method

POST

Content-Type

application/json

2. 認証

不正なアクセスを防ぐため、すべてのリクエストにはHTTPヘッダーにセキュリティトークンを含める必要があります。このトークンは管理者から取得してください。

Header

X-Proxy-Token: YOUR_API_TOKEN_HERE

3. リクエストパラメータ

すべてのパラメータは、JSONリクエストボディで送信する必要があります。

パラメータ	型	必須	説明
プロンプト	文字列	はい	生成したい画像のテキスト説明です。
サイズ	文字列	いいえ	画像の解像度。デフォルト： `1024x1024`サポートされている値： `256x256`, `512x512`, `1024x1024`
生成する画像の数	integer	いいえ	生成する画像の数。デフォルト： `1`推奨範囲： `1–4`

4. cURLの例

curl https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Proxy-Token: YOUR_API_TOKEN_HERE" \
  -d '{
    "prompt": "A futuristic mechanical cat, photorealistic",
    "size": "1024x1024",
    "n": 1
  }'

5. JavaScriptの例

📄

const API_TOKEN = 'YOUR_API_TOKEN_HERE'; // Replace with your actual token

fetch('https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Proxy-Token': API_TOKEN
    },
    body: JSON.stringify({
        "prompt": "A futuristic mechanical cat, photorealistic",
        "size": "1024x1024",
        "n": 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

6. レスポンスフォーマット

📄

5. Response Format

{
    "created": 1773223961,
    "data": [
        {
            "url": "https://example-image-url.com/generated.png"
        }
    ],
    "output_format": "png",
    "usage": {
        "total_tokens": 4182
    }
}

7. エラーレスポンス

エラーが発生した場合、APIはJSON形式のエラーメッセージを返します。

📋

{
  "error": {
    "message": "Invalid API token",
    "code": 403
  }
}

8. ステータスコード

コード	意味
200	リクエスト成功
400	無効なリクエストパラメータ
403	APIトークンが無効、または指定されていません
500	リモートAIサービスが失敗したか、タイムアウトしました