Grok 5 Imagine 생성

API 문서

이 엔드포인트를 사용하여 Grok 5 Imagine 작업을 제출하고 상태를 확인하세요. 각 호출은 사용된 모델에 따라 크레딧을 소모합니다.

인증

모든 요청은 API 키를 헤더에 포함해야 합니다. Authorization header:

Authorization: Bearer <YOUR_API_KEY>

누락되거나 유효하지 않은 키는 반환됩니다. 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

생성 작업 생성

새로운 Grok 5 Imagine 작업을 제출합니다. 호출은 렌더링이 비동기적으로 완료되는 동안 즉시 task_id 를 반환합니다.

매개변수	유형	필수	설명
model	string	아니요	사용할 모델: grok-imagine/text-to-image (기본값), text-to-video, image-to-video 또는 upscale.
input	object	예	모델에 따라 prompt, image_urls 또는 task_id를 포함하는 입력 매개변수 객체.
input.prompt	string (max 5000 chars)	아니요	생성할 내용을 설명하는 텍스트 프롬프트 (text-to-image 및 text-to-video에 필수).
input.image_urls	string[]	아니요	이미지 URL 배열 (image-to-video에 필수).
input.task_id	string	아니요	업스케일 또는 image-to-video 생성을 위한 이전 작업 ID.
callback_url	string	아니요	작업 완료 알림을 받을 웹훅 URL.
public	boolean	아니요	작업을 공개 갤러리에 노출합니다.

크레딧 소비

크레딧은 작업이 생성될 때 차감됩니다. 실패한 작업은 자동으로 환불됩니다.

모델	차감된 크레딧
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

요청 예시

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://grok5imagine.com/api/status

작업 상태 확인

이 엔드포인트를 사용하여 최신 기록을 폴링하세요. 작업이 여전히 IN_PROGRESS(진행 중) 상태일 때는 응답하기 전에 공급자에게 한 번 더 쿼리합니다.

매개변수	유형	필수	설명
task_id	string	예	/generate에서 반환된 ID. 쿼리 (?task_id=) 또는 JSON 본문을 통해 전송합니다.

필드	설명
task_id	/generate에서 반환된 ID.
status	SUCCESS (성공)
request	제출된 페이로드의 정리된 복사본.
response	상태가 SUCCESS일 때 resultUrls 배열을 포함하는 객체.
consumed_credits	작업에 청구된 크레딧 (환불 시 0).
error_message	상태가 FAILED일 때의 공급자 오류 메시지.
created_at	작업이 저장된 UTC 타임스탬프.

요청 예시

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

오류 처리

401 Unauthorized - API 키 누락 또는 유효하지 않음.
402 Payment Required - 크레딧 잔액이 차감액을 충당할 수 없음.
429 Too Many Requests - 폴링 간격 또는 요청 속도를 줄이십시오.
500 - 일시적인 문제; 지수 백오프를 사용하여 다시 시도하십시오.