PopNow API 문서

내 코드에서 이미지·영상·오디오를 생성하세요

API 키 하나, REST 엔드포인트 하나. 모델과 크레딧은 popnow.ai와 똑같습니다. 작업을 보내면 파일을 돌려받습니다.

API 키 발급Playground에서 써 보기빠른 시작 읽기

세 단계로 첫 이미지 만들기

  1. 키 만들기

    popnow.ai에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하고, 계정에 있는 크레딧을 그대로 사용합니다.

  2. 요청 한 번 보내기

    아래 내용을 터미널에 붙여 넣으세요. Z-Image로 이미지 한 장을 만들고 비용은 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로 조회하거나 웹훅으로 받으세요.

    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_…"
}

더 알아보기