모델 - Runbase Docs

Runbase는 하나의 API를 통해 여러 제공업체의 최고 수준 이미지 및 비디오 생성 모델에 대한 액세스를 제공합니다.

모델 탐색

사용 가능한 모든 모델의 가격, 기능, 예시 결과를 보려면 Models page를 방문하세요. 각 모델에는 다음이 포함된 전용 상세 페이지가 있습니다.

Playground — 코드를 작성하기 전에 브라우저에서 모델 테스트
Pricing — 실행당 또는 초당 비용
Examples — 프롬프트가 포함된 샘플 출력
API reference — 모델별 입력 매개변수 및 코드 샘플

Playground

모든 모델 페이지 상단에는 대화형 Playground가 포함되어 있습니다. 로그인하고, 프롬프트를 입력한 다음 Run model을 클릭하면 몇 초 안에 결과를 볼 수 있습니다. 이는 애플리케이션에 통합하기 전에 모델의 품질과 속도를 평가하는 가장 빠른 방법입니다.

모델 ID 형식

모든 모델에는 provider/model-name 형식의 ID가 있습니다. 예를 들면 다음과 같습니다.

openai/gpt-image-2 — 이미지 생성
bytedance/seedance-2 — 비디오 생성
google/veo-3 — 비디오 생성

사용 가능한 전체 모델 목록과 해당 ID는 Models page에 있습니다. 모델은 정기적으로 추가되므로 최신 정보는 সেখানে 확인하세요.

입력 매개변수

각 모델은 자체 입력 스키마를 정의합니다. 일반적인 매개변수는 다음과 같습니다.

prompt (string) — 생성할 내용에 대한 텍스트 설명
aspect_ratio (string) — 출력 크기, 예: "1:1", "16:9"
quality (string) — 생성 품질 등급
image_urls (string[]) — 참조 이미지 URL(지원되는 경우)

전체 입력 스키마와 사용 가능한 옵션은 각 모델의 상세 페이지를 참조하세요.

모델 사용하기

모델 ID와 입력 객체를 create run 엔드포인트에 전달하세요.

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

잘못된 모델 ID를 전달하면 400 model_not_found 오류가 발생합니다. 입력이 모델의 스키마와 일치하지 않으면, 무엇이 잘못되었는지에 대한 설명과 함께 400 invalid_input가 반환됩니다.

이미지 모델 vs. 비디오 모델

이미지 모델은 output.urls에 하나 이상의 이미지 URL을 반환합니다. 생성 시간은 모델, 제공업체 부하, 입력 복잡도에 따라 달라집니다.
비디오 모델은 output.urls에 비디오 URL을 반환합니다. 생성 시간은 모델, 길이, 해상도, 제공업체 부하에 따라 달라집니다.

API 형태는 두 경우 모두 동일하며, 차이점은 출력 URL이 가리키는 대상뿐입니다.