모델 목록

GET /v1/models

현재 사용 가능한 이미지·영상 모델을 반환합니다. 자격 증명이 설정되고 활성화된 모델만 나오므로 목록은 언제든 바뀔 수 있습니다. id를 하드코딩하지 말고 앱 시작 시 한 번 조회하는 것을 권장합니다.

요청

bash

curl https://open.pikpikgo.com/v1/models \
  -H "Authorization: Bearer $PIKPIK_API_KEY"

응답

json

{
  "object": "list",
  "data": [
    {
      "id": "img-std-1",
      "object": "model",
      "type": "image",
      "credits": 10,
      "max_reference_images": 4,
      "specs": [
        { "key": "2k", "name": "2K", "resolution": "2k", "quality": "2k", "credits": 10, "min_sec": 0, "max_sec": 0 }
      ]
    }
  ]
}

항목 설명

항목	설명
id	모델 식별자. 요청 시 model 로 전달하는 값이며, 목록에 없는 id는 오류가 나고 기본 모델로 조용히 대체되지 않는다
type	image=이미지 / video=영상 / text=텍스트
credits	단가. 이미지는 장당, 사양이 없는 영상 모델은 회당
max_reference_images	허용되는 참조 이미지 수. 0이면 미지원
aspect_ratios	동영상만. 이 모델이 허용하는 화면 비율. 빈 배열이면 제한 없음. 목록에 없는 비율은 거부됨
supports_last_frame	동영상만. false면 시작 프레임만 지원하며 image_last 를 보내면 거부됨
max_reference_videos	동영상만. 허용되는 참조 동영상 수. 0이면 미지원
max_reference_audios	동영상만. 허용되는 참조 오디오 수. 0이면 미지원
specs	사양 단계. spec 을 넘기면 해상도와 단가는 해당 단계를 따름
specs[].credits	영상 단계 가격. billing=per_sec는 길이를 곱하고 billing=per_unit은 곱하지 않습니다
specs[].min_sec / max_sec	해당 단계가 허용하는 길이 범위(초). 범위를 벗어난 duration 은 자동 보정

이미지·영상은 model 을 생략하면 기본 모델이 쓰이지만, 기본 모델은 운영에 따라 바뀔 수 있으니 안정성이 필요하면 명시적으로 지정하세요. type=text 항목은 /v1/chat/completions 용이며, 그 엔드포인트는 model 이 필수이고 기본값이 없습니다.