모델

호출할 수 있는 모델마다 모델 ID가 있고, createTask의 model 필드에 넣습니다. 이 페이지 맨 아래 표에 모든 모델과 시작 가격이 있습니다. 모델 이름을 누르면 전체 파라미터 목록, 가격 구간, 바로 복사해 쓸 수 있는 요청이 담긴 레퍼런스 페이지로 갑니다.

모델 ID 구성

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker는 모델을 만든 회사나 팀입니다. PopNow가 직접 만든 도구는 popnow를 씁니다.
• model은 버전의 점을 그대로 둡니다. seedance-2-0이 아니라 seedance-2.0입니다.
• task는 호출이 하는 일입니다. text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio 등이 있으며, 이미지 편집은 항상 edit입니다.

모델 계열 하나에는 보통 작업마다 하나씩 여러 ID가 있습니다. 보내는 내용에 맞게 고르세요. .../text-to-video는 프롬프트만, .../image-to-video는 시작 이미지가 필요합니다.

코드로 카탈로그 읽기

정확한 정보는 실시간 카탈로그에 있습니다. 지금 쓸 수 있는지와 내 계정에 적용되는 가격이 들어 있습니다.

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

목록 필터: modality(image, video, audio), provider, task, search. 여기에 includeSchema=1과 includeExamples=1을 붙이면 입력 스키마와 검증된 입력 예시도 함께 받습니다. HTTP 클라이언트가 경로 파라미터를 한 세그먼트로 다룬다면 슬래시를 %2F로 인코딩하세요.

읽어 둘 필드

가격 읽기

credits는 popnow.ai에 표시되는 것과 같은 가격이며 단위는 크레딧(1크레딧 = $0.01)입니다.

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit은 가격을 세는 방식(per_image 장당, per_second 초당, per_request 요청당, per_1k_characters 1,000자당), perUnit은 시작 가격입니다. 각 규칙은 요청이 when 값과 맞을 때 적용됩니다(*는 구간을 정하는 설정을 뜻하며 여기서는 resolution). 작업의 최종 청구액은 정수 크레딧으로 올림합니다.

특정 요청의 정확한 금액은 createTask에 보낼 본문 그대로 jobs/quote에 물어보세요.

입력 스키마

inputSchema는 표준 JSON Schema(draft 2020-12)입니다. 모든 모델에 다음 규칙이 적용됩니다.

• 모르는 필드는 거부됩니다. aspect_ratio를 잘못 쓰면 조용히 무시되지 않고 400이 옵니다.
• 필드 이름은 모델끼리 공통입니다. 같은 개념은 항상 같은 이름입니다: prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• 기본값은 알아서 채워집니다. 바꾸고 싶은 것만 보내세요.
• 미디어 필드는 공개 HTTPS 링크, 업로드한 popnow:// 파일, 저장한 에셋을 받습니다. 미디어를 참고하세요.
• 표시용 힌트는 각 속성의 x-ui 객체에 있습니다(라벨, 순서, 슬라이더 간격). 검증에는 영향이 없으니 모르는 키는 무시하세요.

seed가 있는 모델에서 생략하면 무작위 값이 골라져 작업의 input에 돌아오므로, 마음에 든 결과를 다시 만들 수 있습니다.

캐시

카탈로그 응답은 내 계정 전용이며 60초 동안 캐시할 수 있습니다. 목록은 몇 분 캐시하고, 모델의 version이 바뀌면 그 모델을 다시 읽고, available: false는 "나중에 다시 하거나 다른 모델을 고르라"는 뜻으로 다루는 것이 좋습니다.

호출할 수 있는 모든 모델

가격은 단위당 가장 낮은 구간입니다. 해상도를 높이거나 길게 만들거나 옵션을 더하면 비싸집니다. 각 모델 페이지에 모든 구간이 있습니다.