개발자 리소스

Grok 5 Imagine API 문서

xAI의 Grok 5 Imagine 모델을 애플리케이션에 통합하세요. 단순한 REST API를 통해 텍스트-투-이미지, 텍스트-투-비디오 및 이미지-투-비디오 생성을 지원합니다.

인증

Grok 5 Imagine API는 Bearer Token 인증을 사용합니다. 요청 헤더에 API 키를 포함하여 전달하세요.

인증

Authorization: Bearer sk-your-api-key-here

API 키를 안전하게 보관하세요. 클라이언트 측 코드에 노출되지 않도록 주의하십시오.

가격 정책

유형	비용	설명
텍스트-투-이미지 `(text2img)`	5 크레딧	Grok 5 AI를 사용하여 텍스트 프롬프트에서 이미지를 생성합니다.
텍스트-투-비디오 `(text2video)`	24 크레딧	Grok 5 AI를 사용하여 텍스트 프롬프트에서 비디오를 생성합니다.
이미지-투-비디오 `(img2video)`	24 크레딧	Grok 5 AI를 사용하여 이미지에서 비디오를 생성합니다.

작업 생성

POSThttps://grok5ai.com/api/generate

비동기 생성

가격 정책

크레딧은 모델에 따라 다릅니다: text2img는 5 크레딧, text2video와 img2video는 각각 24 크레딧입니다.

생성 작업을 시작합니다. API는 즉시 task_id를 반환하며, 이를 사용하여 결과를 폴링할 수 있습니다.

바디 파라미터

파라미터	유형	필수	설명
model	string	필수	사용할 모델: text2img, text2video 또는 img2video.
prompt	string	조건부	생성을 위한 텍스트 설명입니다. 최대 5000자. text2img와 text2video에서 필수.
image_urls	array	조건부	img2video 모드용 이미지 URL 배열. task_id가 제공되지 않은 경우 필수.
task_id	string	조건부	입력 이미지로 사용할 이전 생성의 작업 ID. image_urls가 제공되지 않은 경우 필수.
callback_url	string	선택	작업 완료 알림을 받을 웹훅(Webhook) URL입니다.

요청 예시

텍스트-투-이미지 예시 (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2img",
    "prompt": "A serene mountain landscape at sunset"
  }'

텍스트-투-비디오 예시 (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2video",
    "prompt": "A timelapse of clouds moving over mountains"
  }'

이미지-투-비디오 예시 (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img2video",
    "image_urls": ["https://example.com/image.jpg"]
  }'

성공 응답

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS"
  }
}

오류 응답

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

상태 확인

GEThttps://grok5ai.com/api/status

이 엔드포인트를 폴링하여 작업 진행 상황을 확인하세요. 5~10초 간격으로 폴링하는 것을 권장합니다.

쿼리 파라미터

파라미터	유형	설명
task_id	string	생성 엔드포인트에서 받은 작업 ID입니다. 필수

상태 값

PENDING작업 대기 중

IN_PROGRESS처리 중

SUCCESS완료됨

FAILED오류 발생

cURL

curl -X GET "https://grok5ai.com/api/status?task_id=grok5abc123def456img" \
  -H "Authorization: Bearer YOUR_API_KEY"

응답 (진행 중)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

응답 (완료됨)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

응답 (실패)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

오류 코드

코드	설명
200	성공
400	잘못된 요청 - 유효하지 않은 파라미터 (프롬프트 누락, 잘못된 모델 등)
401	권한 없음 - API 키가 누락되었거나 유효하지 않음
404	찾을 수 없음 - 해당 작업 ID가 존재하지 않음
500	내부 서버 오류 - 다시 시도하거나 고객 지원에 문의하세요

도움이 필요하신가요?

지원 채널을 확인하거나 이메일로 문의해 주세요.

고객 지원 문의