현재 dev 미리보기에서만 사용할 수 있습니다. 운영 환경에는 아직 활성화되지 않았습니다. 검수 시 아래 dev 주소를 사용하세요.
https://devnextapiany.mexxxxai.win
이미지
grok-imagine-image는 요청당 이미지 한 장을 생성합니다(n: 1). 텍스트만 보내면 이미지 생성, image_urls에 공개 HTTPS 이미지 URL 한 개를 보내면 이미지 편집입니다. 기존 이미지 편집 엔드포인트도 유지됩니다. 초기 버전에서는 마스크, 여러 참조 이미지, 사용자 지정 픽셀 크기 및 품질 단계를 지원하지 않습니다.
이미지 size / aspect_ratio: 1:1(기본), 16:9, 9:16, 4:3, 3:4, 3:2, 2:3.
POST /v1/images/generations · POST /v1/images/generations/sync · POST /v1/images/edits
동영상
grok-imagine-video-1.5의 duration은 정수 1~15초(기본 8초), resolution은 480p(기본), 720p, 1080p입니다. 참조 이미지는 최대 한 장입니다. image_urls를 생략하면 텍스트로 동영상을 생성합니다. 이미지 기반 동영상은 입력 이미지 비율을 따르며 aspect_ratio로 변경되지 않습니다.
텍스트 기반 동영상 비율: 16:9(기본), 1:1, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2. 동영상 편집, 여러 참조, 시작·종료 프레임, 사용자 지정 오디오 입력은 초기 버전에 포함되지 않습니다.
POST /v1/videos/generations · POST /v1/videos/generations/sync
크레딧
이미지 생성은 60크레딧, 편집은 66크레딧입니다. 동영상은 길이 × 아래 해상도 단가로 계산하며 이미지 기반 생성은 요청당 30크레딧을 추가합니다. 기존 충전 패키지 할인은 유지됩니다.결과 및 오류
비동기 생성 시 HTTP 202와task_id, poll_url이 반환됩니다. 동기 방식과 이미지 편집은 완료 시 HTTP 200, 처리 중이면 HTTP 202를 반환합니다. /v1/tasks/{task_id}를 completed 또는 failed까지 조회한 뒤 결과 URL을 사용하세요. 대기 중인 작업은 실패가 아닙니다. 파라미터는 크레딧 예약 전에 검증됩니다. 안전 정책 거절은 실패로 처리되므로 동일한 요청을 반복 제출하지 마세요. 동기 방식은 대기 시간 초과 시 아직 완료되지 않은 작업을 반환할 수 있습니다.