PopNow API ドキュメント

画像・動画・音声を、自分のコードから生成する

API キーひとつ、REST エンドポイントひとつ。モデルもクレジットも popnow.ai と同じです。タスクを送れば、ファイルが返ってきます。

API キーを取得Playground で試すクイックスタートを読む

3 ステップで最初の 1 枚

  1. キーを作成する

    popnow.ai にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、アカウントにあるクレジットをそのまま使います。

  2. リクエストを 1 回送る

    これをターミナルに貼り付けて実行します。Z-Image で画像を 1 枚生成し、料金は 2 クレジット（$0.02）。結果は最大 60 秒待って同じレスポンスで受け取ります。

    POST /api/v1/jobs/createTask?wait=60
    export POPNOW_API_KEY="sk-popnow-..."   # your key from the API console

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/z-image-turbo/text-to-image",
  "input": {
    "prompt": "A small red fox curled up in a teacup, soft morning light, studio photo"
  }
}'

  3. 結果を開く

    レスポンスの output.assets[0].url が画像の署名付きリンクです。動画のように時間のかかるジョブは先に taskId が返るので、あとで recordInfo で取得するか Webhook で受け取ります。

    200 OK
    {
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "job_01JH8Z4Q5W2N7R3K9M6P1C0VXD",
    "model": "alibaba/z-image-turbo/text-to-image",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://…signed-link…",
          "expiresAt": "2026-10-16T09:20:00Z",
          "mime": "image/png",
          "width": 1024,
          "height": 1024
        }
      ]
    },
    "credits": 2,
    "cost": "0.02",
    "settled": true
  },
  "request_id": "req_…"
}

さらに詳しく