Runway 이미지 생성
텍스트와 참조 이미지를 사용하여 Gen-4 Image 또는 Gen-4 Image Turbo로 이미지를 생성합니다.
curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
--request POST \
--header "Authorization: Bearer $COMETAPI_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "gen4_image",
"promptText": "A watercolor portrait of @cat_ref.",
"ratio": "1024:1024",
"referenceImages": [
{
"uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
"tag": "cat_ref"
}
]
}'{
"id": "00000000-0000-4000-8000-000000000001"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}gen4_image용 이미지를 생성합니다. Bearer 인증으로 CometAPI API 키를 전송하고
JSON 요청 본문을 함께 보냅니다.
모델 및 참조 선택
모든 요청에는model, promptText, ratio가 필요합니다.
| 모델 | referenceImages |
|---|---|
gen4_image | 선택 사항입니다. 텍스트 전용 생성에는 생략하거나 []를 사용하고, 이미지는 최대 3개까지 제공할 수 있습니다. |
gen4_image_turbo | 이미지를 1~3개 제공합니다. |
gen4_image_turbo의 경우 referenceImages가 필요하며 하나에서
3개의 이미지를 포함해야 합니다. 각 참조 객체에는 이미지 uri와 선택적 항목이 포함됩니다
tag. 태그에는 문자로 시작하는 3~16자의 소문자,
숫자 또는 밑줄을 사용합니다. promptText에서 이를
@tag로 참조합니다. 예: @cat_ref.
이미지 URI에는 접근 가능한 HTTPS URL 또는 최대
5MB의 Base64 이미지 데이터 URI를 사용할 수 있습니다. 프롬프트(Prompt)는 1~1,000개의 UTF-16 코드 단위를 허용합니다.
크기 선택
ratio를 스키마에 지정된 정확한 크기 쌍 중 하나로 설정합니다. 예를 들어
1024:1024 는 정사각형 이미지를 요청하고, 1280:720는 가로 이미지를 요청하며,
720:1280 는 세로 이미지를 요청합니다. ratio를 사용하여 크기를 선택하고, 전송하지 마세요
resolution 또는 size를 이러한 모델과 함께 사용하지 마세요.
명시적 샘플링 시드는 1부터 4294967295까지 사용합니다. 생략하거나 0를 지정하면
무작위 시드가 선택됩니다. contentModeration를 포함하는 경우 해당
publicFigureThreshold 값을 auto 또는 low로 설정하고, 그렇지 않으면 객체를 생략합니다.
결과 가져오기
반환된id를 저장하고 Runway 작업 가져오기.
status가 SUCCEEDED이면 output에서 생성된 이미지 URL을 읽습니다.인증
Use your CometAPI API key.
본문
- gen4_image
- gen4_image_turbo
Request parameters for gen4_image.
Model ID for this request variant.
gen4_image "gen4_image"Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.
1 - 1000Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.
1024:1024, 1080:1080, 1168:880, 1360:768, 1440:1080, 1080:1440, 1808:768, 1920:1080, 1080:1920, 2112:912, 1280:720, 720:1280, 720:720, 960:720, 720:960, 1680:720 Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.
0 <= x <= 4294967295Optional array of up to three reference images. Omit it or use an empty array for text-only generation.
3Show child attributes
Show child attributes
Optional content moderation settings. Omit the object to use standard moderation.
Show child attributes
Show child attributes
응답
Task submitted. Save its id to retrieve task status.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Show child attributes
Show child attributes
Task cost metadata, when returned.
Show child attributes
Show child attributes
curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
--request POST \
--header "Authorization: Bearer $COMETAPI_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "gen4_image",
"promptText": "A watercolor portrait of @cat_ref.",
"ratio": "1024:1024",
"referenceImages": [
{
"uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
"tag": "cat_ref"
}
]
}'{
"id": "00000000-0000-4000-8000-000000000001"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}