본문으로 이동
yollomi
홈API

Yollomi 이미지 및 동영상 모델을 나만의 창작 도구에 연결하세요.

API Documentation

Use your API key to integrate AI image and video generation into your applications. All models use a single unified endpoint.

Authentication
All API requests require authentication. Include your API key in one of these ways:

1. Authorization header (recommended)

Authorization: Bearer YOUR_API_KEY

2. X-API-Key header

X-API-Key: YOUR_API_KEY

Create and manage your API keys in the

Unified Endpoint
Single endpoint for all models. Set type to "image" or "video" and modelId to the model name.
POST https://yollomi.com/api/v1/generate
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "type": "image",
  "modelId": "flux",
  "prompt": "A magical forest with glowing mushrooms",
  "aspectRatio": "1:1",
  "numOutputs": 1
}

Common parameters:

  • type (required): "image" or "video"
  • modelId (required): Model identifier (see list below)
  • aspectRatio: 1:1, 16:9, 9:16
  • Other params: prompt, imageUrl, numOutputs, outputFormat, etc.

Response (image):

{ "images": ["https://..."], "remainingCredits": 96 }

Response (video):

{ "video": "https://...", "remainingCredits": 91 }

Get available models: GET https://yollomi.com/api/v1/models

재개 가능한 생성 요청

새 생성마다 새 Idempotency-Key를 사용하세요. 재시도 시 같은 키와 설정을 재사용하세요.

Prefer: respond-async를 보내면 저장된 작업을 즉시 받습니다. 202는 처리 중을 뜻합니다.

POST /api/v1/generate
Authorization: Bearer YOUR_API_KEY
Idempotency-Key: 87e2af90-40bc-4a61-a190-8a90050e9191
Prefer: respond-async
Content-Type: application/json

{"type":"image","modelId":"flux-schnell","prompt":"A studio product photo"}

HTTP 202
{"jobId":"TASK_UUID","status":"processing","statusUrl":"/api/generation/jobs/TASK_UUID"}

POST /api/generation/jobs/TASK_UUID
Authorization: Bearer YOUR_API_KEY

HTTP 200
{"images":["https://your-media-domain/result.png"],"remainingCredits":8,"jobId":"TASK_UUID"}

이 헤더가 없으면 최대 3분간 기다린 후 아직 처리 중일 때 202를 반환합니다.

동일한 인증으로 statusUrl에 POST하여 작업을 진행하고 확인하세요. GET은 상태만 읽습니다. 200에는 images 또는 video가 포함됩니다.

작업과 키는 완료 후 90일간 유지되며 작품은 별도로 저장됩니다. 409 GENERATION_NEEDS_REVIEW가 나오면 중복 요청하지 말고 지원팀에 문의하세요.

yollomi tasks
yollomi task TASK_UUID
# Reuse a request ID when retrying an interrupted initial submission:
YOLLOMI_REQUEST_ID=87e2af90-40bc-4a61-a190-8a90050e9191 yollomi image "A studio product photo"

사용 가능한 API 모델

기본 요청 설정의 비용입니다. 수량, 품질, 길이, 해상도, 오디오 및 영상 입력에 따라 총비용이 달라집니다. 제공되지 않는 모델은 제외합니다.

이미지 모델 · 25

modelId기본 크레딧
flux4 · 설정에 따라 변동
flux-schnell2 · 설정에 따라 변동
remove-bg0
flux-2-pro15 · 설정에 따라 변동
flux-kontext-pro4
nano-banana4
nano-banana-pro15
nano-banana-27
gpt-image-225 · 설정에 따라 변동
gpt-image-2-5-flare50 · 설정에 따라 변동
gpt-image-2-5-sunburst50 · 설정에 따라 변동
z-image-turbo1
imagen-4-ultra6
image-4-fast3
ideogram-v3-turbo3
stable-diffusion-3-5-large7 · 설정에 따라 변동
seedream-4-54
seedream-5-lite4
object-remover3
image-upscaler1
photo-restoration4
qwen-image-edit3
qwen-image-edit-plus3
virtual-try-on3
ai-background-generator5

영상 모델 · 16

modelId기본 크레딧
openai-sora-250 · 설정에 따라 변동
google-veo-3-1240 · 설정에 따라 변동
kling-2-19
minimax-hailuo-2-360 · 설정에 따라 변동
minimax-hailuo-2-3-fast9
bytedance-seedance-1-pro-fast40 · 설정에 따라 변동
google-veo-3-fast110 · 설정에 따라 변동
google-veo-3250 · 설정에 따라 변동
google-veo-3-1-fast120 · 설정에 따라 변동
runway-gen4-turbo30 · 설정에 따라 변동
pixverse-540 · 설정에 따라 변동
wan-2-5-i2v60 · 설정에 따라 변동
wan-2-6-i2v80 · 설정에 따라 변동
wan-2-5-t2v9
wan-2-6-t2v29 · 설정에 따라 변동
kling-v2-6-motion-control70 · 설정에 따라 변동
Error Responses
Common HTTP status codes

401 – Invalid or missing API key

402 – Insufficient credits

400 – Invalid request (missing modelId, invalid params)

500 – Server error