메인 콘텐츠로 건너뛰기
POST
Text-to-image: generate images from a text prompt
🔒 기본적으로 공개되지 않음: Grok Imagine 2는 Default 그룹에 속하지 않습니다. 자체 Grok_imagine_Reverse 그룹에 속하며, 호출하기 전에 액세스 권한을 요청해야 합니다(이 페이지의 플레이그라운드 포함). 권한이 없으면 모든 호출이 503을 반환합니다.이 제품군의 콘텐츠 안전 정책은 플랫폼의 다른 모델과 상당히 다르며 일부 카테고리는 필터링되지 않습니다. 따라서 규정 준수 리스크를 제한하기 위해 액세스 권한을 선별적으로 부여합니다. 기존 고객은 누적 사용 금액이 $1,000 이상인 경우 사용 사례를 지원팀에 설명하여 활성화할 수 있습니다. 그 외의 사용자는 사용 사례와 적용 중인 콘텐츠 조정 제어를 설명하여 WeCom 지원팀을 통해 신청해야 합니다. 전체 절차는 Grok Imagine 2 개요 - 그룹 설정을 참조하십시오.
오른쪽의 대화형 플레이그라운드에서 엔드포인트를 직접 테스트할 수 있습니다. Authorization에 API Key를 입력하고(형식: Bearer sk-xxx), prompt을 입력한 다음 aspect_ratio / resolution을 선택하여 전송하십시오.
이 페이지를 사용해야 하는 경우: 프롬프트만으로 텍스트를 이미지로 생성하는 경우입니다. 이미지를 업로드하지 않습니다. 기존 이미지를 수정하거나 여러 이미지를 결합하려면 이미지 편집 엔드포인트를 사용하십시오.
⚠️ 이 엔드포인트로 참조 이미지를 전송하지 마십시오여기에 image / image_url / images을 전달해도 오류가 발생하지 않습니다. 200을 반환하고 프롬프트를 바탕으로 완전히 새로운 이미지를 생성하지만, 참조 이미지는 조용히 무시되며 과금은 계속됩니다.오류 신호가 없으므로 일반적으로 결과에 입력 이미지와 전혀 관련이 없다는 것을 누군가 알아차릴 때까지 이 문제가 드러나지 않습니다. 참조 이미지가 포함된 모든 워크플로는 /v1/images/edits을 사용해야 합니다.
⚠️ 잘못된 매개변수는 오류를 발생시키지 않습니다잘못된 aspect_ratio(예: 5:7), resolution(예: 1K, 1024x1024) 및 response_format(예: base64)은 모두 조용히 기본값으로 대체되며 이미지도 계속 반환됩니다. 출력이 예상과 다를 때는 먼저 매개변수 철자를 확인하십시오. resolution 값은 소문자 1k / 2k입니다.한 가지 예외로 resolution: "4k"은 503 model_service_unavailable를 반환합니다. 이는 채널이 중단된 것이 아니라 해당 티어가 지원되지 않는다는 의미입니다. 다시 시도해도 해결되지 않습니다.
모든 이미지 API는 동기식입니다. 비동기 작업 ID가 없으므로 클라이언트 연결이 끊기면 요청에 대한 과금이 진행되는 동안에도 결과를 잃게 됩니다. 1K는 약 9초, 2K는 약 15~17초가 걸리므로 클라이언트 타임아웃을 360초로 설정하십시오. 자세한 내용은 이미지 API 모범 사례를 참조하십시오.

코드 예시

Python (OpenAI SDK)

Python (원시 요청)

cURL

Node.js (네이티브 fetch)

브라우저 JavaScript

매개변수 참조

종횡비별 실제 출력 픽셀:
seed은 지원되지 않습니다(오류 없이 허용되지만 효과가 없으므로 결과를 재현할 수 없습니다). mask 인페인팅도 지원되지 않습니다. size / quality / style과 같은 OpenAI 스타일 필드는 오류 없이 무시됩니다.

응답 형식

응답 필드의 주의사항
  • 각 data[] 항목에는 response_format에 따라 url 또는 b64_json 중 하나만 포함되며, 둘 다 포함되지는 않습니다.
  • revised_prompt은 반환되지 않으며, respect_moderation / model도 반환되지 않습니다. 해당 항목이 존재한다고 가정하지 마십시오.
  • b64_json은 data:image/...;base64, 접두사가 없는 원시 base64이므로 직접 디코딩하십시오.
  • created은 항상 0이며 타임스탬프로 사용할 수 없습니다.
  • n > 1을 사용하는 경우 data 배열에는 여러 항목이 포함되므로 data[0]만 읽지 마십시오.
usage은 대사에 사용할 수 없습니다. 실제 prompt 길이와 관계없이 prompt_tokens은 항상 1000 x n입니다. 이 제품군은 이미지당 고정 요율($0.02 / $0.045)로 과금되므로 실제 청구 금액은 APIYI 콘솔의 과금 기록을 사용하십시오.

인증

Authorization
string
header
필수

API Key created in the APIYI Console

본문

application/json
model
enum<string>
기본값:grok-imagine-image
필수

Model ID. The quality variant delivers higher fidelity at a higher price

사용 가능한 옵션:
grok-imagine-image,
grok-imagine-image-quality
prompt
string
필수

Prompt, English or Chinese. Describe subject, scene, style and lighting in detail

예시:

"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography"

n
integer
기본값:1

Number of images, 1-10. Values of 11 or above return 400; 0 is silently treated as 1

필수 범위: 1 <= x <= 10
예시:

1

aspect_ratio
enum<string>
기본값:1:1

Output aspect ratio. Actual pixel dimensions per resolution tier:

Values outside this enum do not raise an error — they silently fall back to 1:1.

사용 가능한 옵션:
1:1,
16:9,
9:16,
4:3,
3:4
예시:

"16:9"

resolution
enum<string>
기본값:1k

Resolution tier. 1k is roughly 0.9-1.05 megapixels and returns JPEG; 2k is roughly 4.2-4.5 megapixels and returns PNG (5-6 MB per image). Both tiers cost the same.

4k returns 503; other invalid values (such as 1K or 1024x1024) silently fall back to 1k.

사용 가능한 옵션:
1k,
2k
예시:

"1k"

response_format
enum<string>
기본값:url

Response format. url returns a direct image link (no signed query params); b64_json returns a raw base64 string (without the data: prefix).

Invalid values silently fall back to the default url.

사용 가능한 옵션:
url,
b64_json
예시:

"url"

응답

Images generated successfully

created
integer

Creation timestamp. Always 0 for this model — do not use it for timing

예시:

0

data
object[]

Array of image results, length equals the requested n

usage
object

Placeholder values — do not use for billing reconciliation. prompt_tokens is always 1000 x n, regardless of actual prompt length. Use the Console billing records instead.