모델 API

모델 API는 가격이 포함된 모델 카탈로그를 반환하며 API 키가 필요하지 않습니다. 전체 스키마는 OpenAPI 정의와 API 레퍼런스에 있습니다.

GET /v1/models

쿼리 파라미터는 모두 선택 사항이며, 여러 필터는 AND로 결합됩니다.

• modality: 모델의 주 모달리티(modality 필드)가 일치하는 모델만 반환합니다. 오디오도 출력하는 영상 모델은 video로는 반환되지만 audio로는 반환되지 않습니다. 출력하는 모달리티는 모두 capabilities.output_modalities에 들어 있습니다. 값은 text, image, video, audio 중 하나입니다.
• task: 해당 작업을 지원하는 모델만 반환합니다. 값은 chat, text-to-image, image-edit, text-to-video, image-to-video, reference-to-video, text-to-speech 중 하나입니다.
• locale: summary, description, 파라미터 설명의 언어입니다. 값은 en, ja, zh, ko 중 하나이며 기본값은 en입니다.

이 목록에 없는 값을 보내면 400과 invalid_request가 반환되고, error.details.allowed에 허용되는 값이 나열됩니다.

curl "https://api.sakuranbo.ai/v1/models?modality=image&locale=en"

const response = await fetch("https://api.sakuranbo.ai/v1/models?modality=image&locale=en");
const data = await response.json();
console.log(data);

import requests

response = requests.get("https://api.sakuranbo.ai/v1/models?modality=image&locale=en")
print(response.json())

응답에는 object: "list"와 모델의 data 배열이 들어 있습니다. 각 모델에는 다음이 포함됩니다.

• id, name, vendor, vendor_name, modality, tasks, status, endpoint(해당 모델을 실행하는 생성 엔드포인트).
• released_at(출시일이 확인된 경우에만)과 updated_at.
• summary, description, capabilities, parameters(JSON Schema 형식의 입력 필드).
• pricing: 가격 항목마다 한 개. amount_micro_usd(정수), amount_usd(십진수 문자열), conditions(해당 가격을 선택하는 입력값)를 가집니다.
• data_policy, 그리고 모델 페이지와 Markdown 버전으로 연결되는 links.

GET /v1/models/{vendor}/{model}

curl "https://api.sakuranbo.ai/v1/models/sakuranbo/cherryimage-1.0-pro"

const response = await fetch("https://api.sakuranbo.ai/v1/models/sakuranbo/cherryimage-1.0-pro");
const data = await response.json();
console.log(data);

import requests

response = requests.get("https://api.sakuranbo.ai/v1/models/sakuranbo/cherryimage-1.0-pro")
print(response.json())

카탈로그에 없는 ID는 404와 model_not_found를 반환합니다.

공개 GET 응답은 모든 origin을 허용하고, 약한 ETag를 가지며, Cache-Control: public, max-age=60을 사용합니다. 카탈로그가 바뀌지 않았다면 If-None-Match를 보내 304를 받을 수 있습니다.