Skip to main content
POST
플레이그라운드
API 키와 prompt를 입력한 다음 전송합니다. 실시간 API가 호출되며, 코드에서 호출하는 것과 동일한 엔드포인트입니다.
이 페이지에서 전송하는 요청은 실제 요청이며 사용자의 키에 과금됩니다. 이미지 1개당 비용은 모델과 등급에 따라 $0.02~$0.08입니다. 이곳의 어떤 기능도 샌드박스나 모의 환경이 아닙니다.

매개변수

string
필수
실행할 모델입니다. grok-imagine-image, grok-imagine-image-2.0 또는 grok-imagine-image-quality을 허용하며, 정확히 일치해야 합니다 — 별칭은 지원되지 않습니다.
object
필수
생성 매개변수입니다. 아래에 나열되지 않은 키는 invalid_params와 함께 거부됩니다.
string
완료된 작업을 POST할 https URL입니다. 따라서 폴링을 건너뛸 수 있습니다. 반드시 https여야 하며, 그 외의 값은 제출 시점에 거부됩니다.

반환 내용

제출하면 1초 이내에 즉시 반환됩니다. 이미지는 이 응답에 포함되지 않습니다. 생성은 백그라운드에서 진행됩니다.

그런 다음 결과를 폴링합니다

이 플레이그라운드는 생성 호출만 다룹니다. 위 응답의 id를 가져와 statuscompleted 또는 failed에 도달할 때까지 작업을 조회합니다. 약 7~10초가 걸립니다.
완료된 작업에는 outputs 배열이 포함됩니다:
출력 URL은 인증이 필요 없으며 작업 완료 후 24시간이 지나면 만료됩니다. usage.cost_in_usd_ticks정가이며, 잔액은 해당 금액에 그룹 배수를 곱한 만큼 변동합니다. 가격을 참조하세요.

다음 단계

개요

모든 매개변수, 해상도 및 품질 표, 측정된 지연 시간입니다.

비동기 작업 API

폴링 루프, 콜백 및 전체 오류 표입니다.