メインコンテンツまでスキップ

画像を取得する

リクエスト​

curl -X GET \
  https://api.gpuless.io/v1/images \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {YOUR_API_KEY}'

リクエストのパラメーター​

なし

レスポンス​

{
  "images": [
    {
      "status": "generated",
      "image_id":"092cb6da-e1cd-4324-89d4-b7799a9f3166",
      "metadata": {
        "model":"anything-v4",
        "prompt":"(masterpiece) 1girl maid cat ear",
        "negative_prompt":"nsfw"
      },
      "image_url": "https://api.gpuless.io/v1/images/092cb6da-e1cd-4324-89d4-b7799a9f3166",
      "raw_image_url": "https://api.gpuless.io/v1/images/092cb6da-e1cd-4324-89d4-b7799a9f3166/raw"
    }
  ]
}

レスポンスのパラメーター​

image_urlはクライアントサイドでの表示に適したavif形式の画像ファイルのURLです。 PNGと比較して、ファイルサイズが90%程度小さくなります。 また、この画像はユーザーに近いロケーションで自動的にキャッシュされ非常に高速に表示できます。通常1ファイルのサイズは30~50kbです。

raw_image_urlはimage_urlと同じ画像ですが、png形式の画像ファイルのURLです。 バックエンドからアクセスして保存に使う事を意図しています。 通常1ファイルあたりのサイズは300~500kbです。

フロントエンドでの表示にはできる限りimage_urlを使ってください。

キー型必須備考
image_idstring○UUIDv4による画像の一意な識別子
statusstring○画像の生成状況 work_in_progress,generated,error
modelstring○AIモデル名現在はanything-v4のみ対応
metadataobject画像生成に使ったメタデータ
image_urlstring○avif形式画像ファイルのurl
raw_image_urlstring○png形式画像ファイルのurl