{ "aboutHtml": "

Qwen-Image-3.0 Pro는 이미지 생성과 편집을 위한 Qwen의 주력 3세대 모델입니다. 복잡한 배치 생성, 세밀하고 사실적인 질감, 다국어 타이포그래피, 이미지 요청에 대한 충실한 지시 이행을 결합합니다. Pro와 일반 Qwen-Image-3.0은 문서에 명시된 생성·편집 모드를 공유합니다. Pro는 이미지 품질을 강조하고, 일반 에디션은 품질과 속도의 균형을 맞춥니다. 결과물은 렌더링된 이미지입니다.

정보가 많은 그래픽에서는 모양보다 내용을 먼저 정의하세요. 제목, 보조 텍스트, 수치, 계층, 섹션 간 관계를 지정하세요. 유용한 제품 요청은 하나의 캔버스에 주요 객체, 재질의 근접 디테일, 라벨이 붙은 특징을 결합할 수 있습니다. 교육용 일러스트에서는 모델이 바탕이 되는 사실을 만들어 내도록 맡기지 말고 개념, 도식 구조, 정확한 설명 문구를 지정하세요. 복잡한 배치는 여러 패널이나 중첩된 인터페이스도 보여 줄 수 있습니다. 프롬프트의 권장 최대 길이인 4,500토큰은 무엇이 어디에 나타나야 하는지에 집중해서 사용하세요.

3.0 계열은 12개 언어의 네이티브 타이포그래피, 여러 글꼴, 100가지가 넘는 예술 스타일, 머리카락·피부·직물 같은 미세한 질감을 지원합니다. 10픽셀처럼 작은 크기의 텍스트를 렌더링한 시연도 제시되어 있습니다. 글자를 물리적 재질에 녹여 넣거나 텍스트를 사실적인 이미지와 결합하는 디자인에 활용할 수 있습니다. 정확한 문구, 숫자, 언어를 제공하고 각 블록의 타이포그래피 역할을 설명하세요. 신문 페이지나 인터페이스 목업도 여전히 그림입니다. 나중에 편집 가능한 배치나 상호작용 동작을 만들려면 이를 바탕으로 별도의 결과물을 구현해야 합니다.

Pro는 이미지 안의 텍스트를 편집하고, 요소를 추가·삭제·이동하며, 피사체의 동작을 바꾸고, 시각적 스타일을 옮기며, 디테일을 강화할 수 있습니다. 편집에는 지시와 함께 1–3개의 입력 이미지를 사용할 수 있습니다. 이미지 순서가 요청에서 이미지 1, 이미지 2, 이미지 3을 결정합니다. 어느 참조가 피사체의 정체성을 제공하고, 어느 참조가 객체나 의상을 제공하며, 어느 참조가 배경이나 포즈를 제공하는지 지정하세요. 특정 변경에 집중한 편집에서는 바꿀 내용과 그대로 유지할 특징을 모두 밝혀, 생성 이미지와 참조를 쉽게 비교할 수 있도록 합니다.

지원 입력 형식은 JPG, JPEG, PNG, BMP, TIFF, WebP, GIF이며, 애니메이션 GIF는 첫 번째 프레임만 사용합니다. 입력 이미지당 최대 크기는 10 MB입니다. 해당 API는 변 길이 1부터 8,000픽셀까지와 긴 변 대 짧은 변의 비율 10:1 이하를 허용하며, 권장 범위는 384–2,048픽셀입니다. 편집 가이드는 별도로 최대 3,072픽셀 이미지를 권장합니다. 따라서 입력 선택은 필요한 디테일을 준비하는 과정으로 보아야 하며, 어떤 해상도든 결과가 더 좋아진다는 약속으로 보아서는 안 됩니다. 작은 텍스트나 재질 특징에는 읽을 수 있고 적절하게 프레이밍된 참조를 사용하세요.

출력은 PNG입니다. 제작사 작업 흐름은 기본값 1개로 1–6개의 대안을 반환하며, 전체 픽셀 면적 512 × 512부터 2,048 × 2,048까지와 종횡비 1:8부터 8:1까지를 지원합니다. 픽셀 면적 예산은 긴 변이 2,048픽셀을 넘는 일부 비정사각형 크기도 허용합니다. 크기를 지정하지 않으면 모델이 요청에 따라 해상도를 권장합니다. 실제 배치 위치에 맞는 형태를 선택하고, 의도한 표시 크기에서 내용의 완전성, 피사체 디테일, 타이포그래피를 기준으로 생성된 대안을 비교하세요.

지능형 프롬프트 재작성은 기본으로 활성화됩니다. 직접 개선은 생성과 편집 모두에서 사용할 수 있지만, 에이전트 개선은 텍스트 기반 이미지 생성 프롬프트를 다듬는 기능이며 이미지 기반 이미지 편집에는 사용할 수 없습니다. Thinking도 기본으로 활성화되며 프롬프트 재작성이 필요합니다. 추론 작업과 생성 시간이 추가됩니다. 네거티브 프롬프트는 원치 않는 요소를 지정하고, 선택적인 seed는 변형 간 비교를 더 일관되게 만드는 데 도움이 될 수 있습니다. 그래도 명확한 긍정형 요청에서 피사체, 구도, 유지할 디테일을 정해야 합니다.

실용적인 결과 검토에서는 정확한 텍스트, 숫자, 읽기 순서, 참조 충실도, 디자인에 중요한 경계나 질감을 확인합니다. 특정 부분을 수정해야 할 때는 잘 나온 구도를 유지하고 해당 부분의 변경을 설명하세요. 제작사의 출력 위치는 24시간 후 만료되므로 선택한 모든 이미지와 프롬프트, 참조를 함께 보관하세요. Pro에 명시된 모드와 제한은 3.0 에디션에 해당합니다. Qwen 2.1에 설명된 10개 참조와 네이티브 투명도 기능은 별도 에디션의 기능입니다.

", "aboutText": "Qwen-Image-3.0 Pro는 이미지 생성과 편집을 위한 Qwen의 주력 3세대 모델입니다. 복잡한 배치 생성, 세밀하고 사실적인 질감, 다국어 타이포그래피, 이미지 요청에 대한 충실한 지시 이행을 결합합니다. Pro와 일반 Qwen-Image-3.0은 문서에 명시된 생성·편집 모드를 공유합니다. Pro는 이미지 품질을 강조하고, 일반 에디션은 품질과 속도의 균형을 맞춥니다. 결과물은 렌더링된 이미지입니다.\n\n정보가 많은 그래픽에서는 모양보다 내용을 먼저 정의하세요. 제목, 보조 텍스트, 수치, 계층, 섹션 간 관계를 지정하세요. 유용한 제품 요청은 하나의 캔버스에 주요 객체, 재질의 근접 디테일, 라벨이 붙은 특징을 결합할 수 있습니다. 교육용 일러스트에서는 모델이 바탕이 되는 사실을 만들어 내도록 맡기지 말고 개념, 도식 구조, 정확한 설명 문구를 지정하세요. 복잡한 배치는 여러 패널이나 중첩된 인터페이스도 보여 줄 수 있습니다. 프롬프트의 권장 최대 길이인 4,500토큰은 무엇이 어디에 나타나야 하는지에 집중해서 사용하세요.\n\n3.0 계열은 12개 언어의 네이티브 타이포그래피, 여러 글꼴, 100가지가 넘는 예술 스타일, 머리카락·피부·직물 같은 미세한 질감을 지원합니다. 10픽셀처럼 작은 크기의 텍스트를 렌더링한 시연도 제시되어 있습니다. 글자를 물리적 재질에 녹여 넣거나 텍스트를 사실적인 이미지와 결합하는 디자인에 활용할 수 있습니다. 정확한 문구, 숫자, 언어를 제공하고 각 블록의 타이포그래피 역할을 설명하세요. 신문 페이지나 인터페이스 목업도 여전히 그림입니다. 나중에 편집 가능한 배치나 상호작용 동작을 만들려면 이를 바탕으로 별도의 결과물을 구현해야 합니다.\n\nPro는 이미지 안의 텍스트를 편집하고, 요소를 추가·삭제·이동하며, 피사체의 동작을 바꾸고, 시각적 스타일을 옮기며, 디테일을 강화할 수 있습니다. 편집에는 지시와 함께 1–3개의 입력 이미지를 사용할 수 있습니다. 이미지 순서가 요청에서 이미지 1, 이미지 2, 이미지 3을 결정합니다. 어느 참조가 피사체의 정체성을 제공하고, 어느 참조가 객체나 의상을 제공하며, 어느 참조가 배경이나 포즈를 제공하는지 지정하세요. 특정 변경에 집중한 편집에서는 바꿀 내용과 그대로 유지할 특징을 모두 밝혀, 생성 이미지와 참조를 쉽게 비교할 수 있도록 합니다.\n\n지원 입력 형식은 JPG, JPEG, PNG, BMP, TIFF, WebP, GIF이며, 애니메이션 GIF는 첫 번째 프레임만 사용합니다. 입력 이미지당 최대 크기는 10 MB입니다. 해당 API는 변 길이 1부터 8,000픽셀까지와 긴 변 대 짧은 변의 비율 10:1 이하를 허용하며, 권장 범위는 384–2,048픽셀입니다. 편집 가이드는 별도로 최대 3,072픽셀 이미지를 권장합니다. 따라서 입력 선택은 필요한 디테일을 준비하는 과정으로 보아야 하며, 어떤 해상도든 결과가 더 좋아진다는 약속으로 보아서는 안 됩니다. 작은 텍스트나 재질 특징에는 읽을 수 있고 적절하게 프레이밍된 참조를 사용하세요.\n\n출력은 PNG입니다. 제작사 작업 흐름은 기본값 1개로 1–6개의 대안을 반환하며, 전체 픽셀 면적 512 × 512부터 2,048 × 2,048까지와 종횡비 1:8부터 8:1까지를 지원합니다. 픽셀 면적 예산은 긴 변이 2,048픽셀을 넘는 일부 비정사각형 크기도 허용합니다. 크기를 지정하지 않으면 모델이 요청에 따라 해상도를 권장합니다. 실제 배치 위치에 맞는 형태를 선택하고, 의도한 표시 크기에서 내용의 완전성, 피사체 디테일, 타이포그래피를 기준으로 생성된 대안을 비교하세요.\n\n지능형 프롬프트 재작성은 기본으로 활성화됩니다. 직접 개선은 생성과 편집 모두에서 사용할 수 있지만, 에이전트 개선은 텍스트 기반 이미지 생성 프롬프트를 다듬는 기능이며 이미지 기반 이미지 편집에는 사용할 수 없습니다. Thinking도 기본으로 활성화되며 프롬프트 재작성이 필요합니다. 추론 작업과 생성 시간이 추가됩니다. 네거티브 프롬프트는 원치 않는 요소를 지정하고, 선택적인 seed는 변형 간 비교를 더 일관되게 만드는 데 도움이 될 수 있습니다. 그래도 명확한 긍정형 요청에서 피사체, 구도, 유지할 디테일을 정해야 합니다.\n\n실용적인 결과 검토에서는 정확한 텍스트, 숫자, 읽기 순서, 참조 충실도, 디자인에 중요한 경계나 질감을 확인합니다. 특정 부분을 수정해야 할 때는 잘 나온 구도를 유지하고 해당 부분의 변경을 설명하세요. 제작사의 출력 위치는 24시간 후 만료되므로 선택한 모든 이미지와 프롬프트, 참조를 함께 보관하세요. Pro에 명시된 모드와 제한은 3.0 에디션에 해당합니다. Qwen 2.1에 설명된 10개 참조와 네이티브 투명도 기능은 별도 에디션의 기능입니다.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b4db8348edaafe5eb696644b443682331ca075c50c4ef4755eb23f6c4d7fb51e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ko", "methods": [ { "html": "
Al

Qwen: Qwen Image 3 Pro

Alibaba /qwen/qwen-image-3-pro

시작하기

Qwen-Image-3.0 Pro는 복잡한 배치, 사실적인 디테일, 다국어 텍스트를 위한 Qwen의 주력 이미지 생성·편집 모델입니다. 명확한 요청이나 1–3개의 참조를 사용해 그래픽, 제품 장면, 특정 변경에 집중한 시각적 편집을 만드세요.

허용 입력
텍스트 · 이미지
결과
이미지
모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

Qwen-Image-3.0 Pro는 이미지 생성과 편집을 위한 Qwen의 주력 3세대 모델입니다. 복잡한 배치 생성, 세밀하고 사실적인 질감, 다국어 타이포그래피, 이미지 요청에 대한 충실한 지시 이행을 결합합니다. Pro와 일반 Qwen-Image-3.0은 문서에 명시된 생성·편집 모드를 공유합니다. Pro는 이미지 품질을 강조하고, 일반 에디션은 품질과 속도의 균형을 맞춥니다. 결과물은 렌더링된 이미지입니다.

정보가 많은 그래픽에서는 모양보다 내용을 먼저 정의하세요. 제목, 보조 텍스트, 수치, 계층, 섹션 간 관계를 지정하세요. 유용한 제품 요청은 하나의 캔버스에 주요 객체, 재질의 근접 디테일, 라벨이 붙은 특징을 결합할 수 있습니다. 교육용 일러스트에서는 모델이 바탕이 되는 사실을 만들어 내도록 맡기지 말고 개념, 도식 구조, 정확한 설명 문구를 지정하세요. 복잡한 배치는 여러 패널이나 중첩된 인터페이스도 보여 줄 수 있습니다. 프롬프트의 권장 최대 길이인 4,500토큰은 무엇이 어디에 나타나야 하는지에 집중해서 사용하세요.

3.0 계열은 12개 언어의 네이티브 타이포그래피, 여러 글꼴, 100가지가 넘는 예술 스타일, 머리카락·피부·직물 같은 미세한 질감을 지원합니다. 10픽셀처럼 작은 크기의 텍스트를 렌더링한 시연도 제시되어 있습니다. 글자를 물리적 재질에 녹여 넣거나 텍스트를 사실적인 이미지와 결합하는 디자인에 활용할 수 있습니다. 정확한 문구, 숫자, 언어를 제공하고 각 블록의 타이포그래피 역할을 설명하세요. 신문 페이지나 인터페이스 목업도 여전히 그림입니다. 나중에 편집 가능한 배치나 상호작용 동작을 만들려면 이를 바탕으로 별도의 결과물을 구현해야 합니다.

Pro는 이미지 안의 텍스트를 편집하고, 요소를 추가·삭제·이동하며, 피사체의 동작을 바꾸고, 시각적 스타일을 옮기며, 디테일을 강화할 수 있습니다. 편집에는 지시와 함께 1–3개의 입력 이미지를 사용할 수 있습니다. 이미지 순서가 요청에서 이미지 1, 이미지 2, 이미지 3을 결정합니다. 어느 참조가 피사체의 정체성을 제공하고, 어느 참조가 객체나 의상을 제공하며, 어느 참조가 배경이나 포즈를 제공하는지 지정하세요. 특정 변경에 집중한 편집에서는 바꿀 내용과 그대로 유지할 특징을 모두 밝혀, 생성 이미지와 참조를 쉽게 비교할 수 있도록 합니다.

지원 입력 형식은 JPG, JPEG, PNG, BMP, TIFF, WebP, GIF이며, 애니메이션 GIF는 첫 번째 프레임만 사용합니다. 입력 이미지당 최대 크기는 10 MB입니다. 해당 API는 변 길이 1부터 8,000픽셀까지와 긴 변 대 짧은 변의 비율 10:1 이하를 허용하며, 권장 범위는 384–2,048픽셀입니다. 편집 가이드는 별도로 최대 3,072픽셀 이미지를 권장합니다. 따라서 입력 선택은 필요한 디테일을 준비하는 과정으로 보아야 하며, 어떤 해상도든 결과가 더 좋아진다는 약속으로 보아서는 안 됩니다. 작은 텍스트나 재질 특징에는 읽을 수 있고 적절하게 프레이밍된 참조를 사용하세요.

출력은 PNG입니다. 제작사 작업 흐름은 기본값 1개로 1–6개의 대안을 반환하며, 전체 픽셀 면적 512 × 512부터 2,048 × 2,048까지와 종횡비 1:8부터 8:1까지를 지원합니다. 픽셀 면적 예산은 긴 변이 2,048픽셀을 넘는 일부 비정사각형 크기도 허용합니다. 크기를 지정하지 않으면 모델이 요청에 따라 해상도를 권장합니다. 실제 배치 위치에 맞는 형태를 선택하고, 의도한 표시 크기에서 내용의 완전성, 피사체 디테일, 타이포그래피를 기준으로 생성된 대안을 비교하세요.

지능형 프롬프트 재작성은 기본으로 활성화됩니다. 직접 개선은 생성과 편집 모두에서 사용할 수 있지만, 에이전트 개선은 텍스트 기반 이미지 생성 프롬프트를 다듬는 기능이며 이미지 기반 이미지 편집에는 사용할 수 없습니다. Thinking도 기본으로 활성화되며 프롬프트 재작성이 필요합니다. 추론 작업과 생성 시간이 추가됩니다. 네거티브 프롬프트는 원치 않는 요소를 지정하고, 선택적인 seed는 변형 간 비교를 더 일관되게 만드는 데 도움이 될 수 있습니다. 그래도 명확한 긍정형 요청에서 피사체, 구도, 유지할 디테일을 정해야 합니다.

실용적인 결과 검토에서는 정확한 텍스트, 숫자, 읽기 순서, 참조 충실도, 디자인에 중요한 경계나 질감을 확인합니다. 특정 부분을 수정해야 할 때는 잘 나온 구도를 유지하고 해당 부분의 변경을 설명하세요. 제작사의 출력 위치는 24시간 후 만료되므로 선택한 모든 이미지와 프롬프트, 참조를 함께 보관하세요. Pro에 명시된 모드와 제한은 3.0 에디션에 해당합니다. Qwen 2.1에 설명된 10개 참조와 네이티브 투명도 기능은 별도 에디션의 기능입니다.

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 이미지 POST /v1/images/generations
입력
text, image
출력
image
필드유형요건값과 한도기본값
필드model유형string요건필수값과 한도
qwen/qwen-image-3-pro
기본값—
필드prompt유형string요건필수값과 한도
최소 길이: 1
기본값—
필드resolution유형string요건선택 사항값과 한도
1K, 2K
기본값—
필드aspect_ratio유형string요건선택 사항값과 한도
1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9
기본값—
필드n유형integer요건선택 사항값과 한도
최솟값: 1
최댓값: 6
기본값—
필드input_references유형array요건선택 사항값과 한도
최소 항목 수: 0
최대 항목 수: 4
기본값—
필드provider유형object요건선택 사항값과 한도기본값—
메서드 매개변수와 수명 주기
매개변수명세
매개변수content_type명세application/json
매개변수required명세model, prompt
매개변수material_types명세text, image

수명 주기: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 미디어 라이브러리 기록

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

요금

최종 요금 계산 방식

표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드
미지정 빠른 모드를 선택한 경우
Flex 모드
미지정 flex 모드를 선택한 경우
최대 추론 수준
미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정요금표예측 수량과금 단위요금
설정기본 토큰 요금요금표기본 요금예측 수량—과금 단위—요금
입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰
출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰
입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정입력 이미지요금표—예측 수량—과금 단위입력 이미지당요금
입력 · 입력 이미지 · 비교 전용 추정치 $0.006 입력 이미지당
설정예상 생성 비용요금표—예측 수량1회 생성 예상치과금 단위—요금
출력 · 예상 생성 비용 · 비교 전용 추정치 $0.08 생성 전 추정치

이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 이미지

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

결과 수신 및 저장

Ailoot Ultra · 이미지

반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요

기타 콘텐츠 조회
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n
완료된 결과 모두 보관

완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.

전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.

원래 응답을 확인해야 할 경우

정산 대조를 위해 반환된 X-Client-Request-ID를 보관하세요. 실제로 반환된 task_id/asset_id 값이나 소유한 미디어 라이브러리만 조회하세요. 작업 ID로 태스크 URL을 만들거나 생성 요청을 다시 제출하지 마세요.

응답 필드
필드유형
필드created유형
필드data[].url유형
필드data[].b64_json유형
필드usage유형

별칭

모델 별칭

Ailoot Ultra qwen/qwen-image-3-pro

메서드 경로 별칭

/v1/images

관련 호출용 ID

qwen/qwen-image-3-pro

", "method_identity": { "effective_request_model_id": "qwen/qwen-image-3-pro", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "qwen/qwen-image-3-pro", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|qwen%2Fqwen-image-3-pro", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "정산 대조를 위해 반환된 X-Client-Request-ID를 보관하세요. 실제로 반환된 task_id/asset_id 값이나 소유한 미디어 라이브러리만 조회하세요. 작업 ID로 태스크 URL을 만들거나 생성 요청을 다시 제출하지 마세요." }, "outputs": { "all_results": "전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "qwen/qwen-image-3-pro" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1K", "2K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "1:1", "1:2", "1:4", "2:1", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "9:16", "16:9" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 4, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "1:2", "1:4", "2:1", "2:3", "3:2", "3:4", "4:1", "4:3", "4:5", "5:4", "9:16", "16:9" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 4, "minItems": 0, "type": "array" }, "model": { "enum": [ "qwen/qwen-image-3-pro" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "1K", "2K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "qwen/qwen-image-3-pro", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "실제로 반환된 task_id 또는 미디어 라이브러리 기록", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "input image", "units": [ { "amount": "0.006", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0.006", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "basis": "이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "예상 생성 비용", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'qwen/qwen-image-3-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"