레퍼런스를 지원하는 Runway의 Gen-4 Image 모델입니다. 최대 3장의 레퍼런스 이미지를 프롬프트 속 @태그로 지칭해 캐릭터·사물·장소를 어떤 앵글과 장면에서도 일관되게 유지하며, 720p 또는 1080p로 생성합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "runwayml/gen4-image",
"input": {
"prompt": "a close up portrait of @woman and @man standing in @park, hands in pockets, looking cool. She is wearing her pink sweater and bangles.",
"resolution": "1080p",
"aspect_ratio": "4:3",
"reference_tags": [
"park",
"woman",
"man"
],
"reference_images": [
"https://example.com/park.jpg",
"https://example.com/woman.jpg",
"https://example.com/man.jpg"
]
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 이미지 생성을 위한 텍스트 프롬프트. @태그명으로 레퍼런스 이미지를 지칭 |
seed | integer | No | - | 랜덤 시드. 재현 가능한 생성을 위해 설정 |
resolution | string | No | 1080p | 이미지 해상도 — 720p는 150크레딧, 1080p는 240크레딧 과금 720p1080p |
aspect_ratio | string | No | 16:9 | 이미지 화면 비율 16:99:164:33:41:121:9 |
reference_tags | array | No | [] | 각 레퍼런스 이미지에 붙이는 태그. 프롬프트에서 @태그명으로 사용. 영숫자, 문자로 시작, 3~15자 |
reference_images | array | No | [] | 최대 3장의 레퍼런스 이미지. 화면 비율은 0.5~2 사이여야 함 |
이 모델의 reference_images 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=runwayml/gen4-image" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:reference_images=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "runwayml/gen4-image",
"input": {
"prompt": "your prompt here",
"reference_images": ["https://example.com/image.jpg"]
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
3장의 레퍼런스(공원·여성·남성)를 @태그로 결합한 예시
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "runwayml/gen4-image",
"input": {
"prompt": "a close up portrait of @woman and @man standing in @park, hands in pockets, looking cool. She is wearing her pink sweater and bangles.",
"resolution": "1080p",
"aspect_ratio": "4:3",
"reference_tags": [
"park",
"woman",
"man"
],
"reference_images": [
"https://example.com/park.jpg",
"https://example.com/woman.jpg",
"https://example.com/man.jpg"
]
}
}'