Imagine
Grok Build는 분할된 Imagine 컴퓨터 스택 (grok_computer 변형)을 사용합니다.
통합된 imagine_image 또는 imagine_video 도구는 없습니다 — 항상 아래 표에서 양식별 이름을 호출하세요.
| 도구 | 역할 |
|---|---|
imagine_text_to_image | 텍스트 프롬프트만으로 새 이미지 생성 (소스 없음). |
imagine_image_to_image | 기존 이미지 하나 편집 / 스타일 변경 (샌드박스 경로). |
imagine_reference_to_image | 2개 이상의 참조 이미지 결합 (샌드박스 경로). |
imagine_text_to_video | 텍스트 프롬프트만으로 새 비디오 생성 (소스 없음). |
imagine_image_to_video | 정지 이미지 하나 (샌드박스 경로)를 비디오로 애니메이션. |
imagine_reference_to_video | 1개 이상의 참조 이미지 (샌드박스 경로)로 비디오 생성. |
render_file | 샌드박스의 이미지/비디오 경로를 채팅에서 사용자에게 표시. |
경로 기반 핸들. 이 도구들은 공유 샌드박스를 읽고 씁니다:
- 생성은 샌드박스
file_path(artifacts 아래)를 반환합니다.read_file/ 셸로 열고,render_file로 사용자에게 표시하세요. - 편집 / 애니메이션 도구는 해당 경로(들)를 입력으로 받습니다 — 실제 스키마 (
image,images등)와 일치시킵니다. 경로를 임의로 만들지 마세요. imagine_image/imagine_video를 호출하지 마세요. 자산 ID 헬퍼 (imagine_create_asset/imagine_view_media/render_imagine_media)는 이 스택에 포함되지 않습니다.
이 도구들 중 하나를 고려하거나 호출하려 할 때마다 이 내용을 적용하세요.
핸들 흐름 (필수적 정신 모델)
generate → file_path → render_file (사용자에게 표시) / read_file 또는 스크립트 (품질 검사)
edit / animate → 이전 file_path(들)을 image_to_* / reference_to_*에 전달
- 도구가 실제로 반환한 경로를 사용하세요 — 파일 시스템 경로를 임의로 만들지 마세요.
- 사용자에게 미디어를 표시할 때는
render_file을 사용하고, 임시방편의 마크다운 이미지 링크를 사용하지 마세요.
코드로 정확한 시각 자료 구축하기 (이미지 도구 대신)
- 이미지 모델은 정확한 텍스트, 숫자 및 구조에 신뢰할 수 없습니다. 짧은 텍스트나 간단한 레이아웃은 처리할 수 있지만, 종종 단어를 왜곡하고, 숫자를 지어내며, 실제 데이터와 일치하지 않는 차트 막대를 그리고, 다이어그램 화살표를 아무 데나 가리킵니다. 정확해야 할 것이 많을수록 성능은 더 나빠집니다. 상세한 프롬프트가 이를 신뢰할 수 있게 만들지 않으며, 또 다른
imagine_image_to_image편집으로는 대개 해결되지 않습니다. 따라서 특정 텍스트, 데이터 또는 구조가 정확해야 하는 결과(실제 숫자로 만든 차트, 라벨이 있는 기술 다이어그램, 수학 설명, 표, 실제 카피가 있는 화면)가 필요할 때는 코드로 자산을 구축하여 정확한 내용을 제어하세요. 파이썬 플로팅보다 훨씬 나은 레이아웃, 타이포그래피 및 마감을 제공하는 HTML과 CSS를 선호하세요. 외관만 중요한 경우(사진, 일러스트레이션, 캐릭터, 장면, 장식 예술)에는 이미지 도구가 올바른 선택입니다. 어느 쪽이 적합한지는 요청이 어떻게 표현되었는지가 아니라 출력물이 무엇을 정확히 해야 하는지에 달려 있습니다.
개별 정확성 확인 (반복 루프)
출력물이 특정 텍스트, 숫자, 데이터 또는 구조를 정확히 표현해야 할 때는 첫 번째 결과를 신뢰하지 말고 반복 루프로 확인하세요.
- 결과를 생성합니다 (생성하거나, 정확한 시각 자료를 코드로 구축하기에 따라 코드로 구축).
- 실제 출력을 검사합니다 — 결과 경로에
read_file(이미지 이해)을 사용하여 — 모든 단어, 숫자, 라벨 및 구조적 세부 사항이 요구 사항과 일치하고, 겹치거나 잘리거나 캔버스 밖으로 나가는 요소가 없는지 확인합니다. - 문제가 있으면 수정하고 재확인합니다:
- 이미지 모델에서 단어가 왜곡되거나, 숫자가 지어졌거나, 레이아웃이 깨졌습니까? 단순히 프롬프트를 다시 입력하지 마세요 — 아마 다시 왜곡될 것입니다. 코드로 재구축하세요.
- 코드로 빌드한 출력에서 요소가 겹치거나 잘렸습니까? 좌표를 수동으로 조정하는 대신 자동 레이아웃 (HTML/CSS)으로 재배치하세요.
- 그 외의 경우 이전 경로를 사용하여
imagine_image_to_image로 한 번의 대상 편집을 수행합니다.
- 개별 콘텐츠가 정확히 맞을 때만 완료합니다. 정확하게 만들 수 없다면 잘못된 것을 제공하는 대신 사용자에게 알리세요.
핵심 원칙
- 프롬프트는 당신이 만듭니다. 사용자가 상세한 프롬프트를 제공하거나 자신의 프롬프트를 사용하도록 요청하면 그대로 사용하세요. 그렇지 않으면 최종 프롬프트를 직접 만드세요: 주제를 앞에 배치하고, 모든 세부 사항을 과도하게 지정하지 않으면서 분위기, 구성, 조명 및 스타일에 대해 강력한 높은 수준의 방향을 제시하며, 키워드 태그 대신 자연스러운 산문을 작성하고, 부정 프롬프트 대신 긍정적으로 설명하세요. 편집의 경우 변경 사항만 설명하세요. 2-5문장을 목표로 하세요.
- 실제 인물은 참조 우선. 지명된 실제 인물이나 그룹에 대해 순수 텍스트-이미지를 절대 사용하지 마세요. 얼굴 바꾸기, 포스터, 만화, 영화적 또는 에디토리얼 묘사를 포함합니다. 대신 실제 참조 경로와 함께
imagine_image_to_image를 사용하고, 비동의적이거나 성적 대상화되었거나 미성년자가 포함된 초상은 절대 생성하지 마세요. 절차는 실제 인물 및 참조를 참조하세요. - 먼저 검색으로 사실을 확인하세요. 요청의 어떤 부분이라도 실제 세계의 사실, 정체성, 브랜드 또는 제품, 장소, 사건, 최신/최고/현재 결과에 의존한다면, 생성하기 전에 웹을 검색하고 확인된 실제 세부 사항을 프롬프트에 넣으세요. 기억에 의존하지 말고 "현재 대통령"과 같은 모호한 자리표시자를 작성하지 말고 확인된 이름을 작성하세요.
- 일관성을 위해 기본 이미지를 재사용하세요. 동일한 캐릭터, 객체 또는 배경이 여러 이미지에 나타나야 할 때는
imagine_text_to_image로 하나의 기본 이미지를 생성하고, 그file_path를 유지한 다음, 모든 변형에 대해 해당 경로를imagine_image_to_image에 전달하세요. 반복되는 주제에 대해 매번 처음부터 텍스트-이미지를 다시 실행하지 마세요. - 실패를 우아하게 처리하세요. 검열 또는 안전 차단이 발생하면 중단하세요. 재시도하지 말고 필터를 회피하기 위해 프롬프트를 바꿔 말하지 마세요. 사용자에게 차단되었음을 알리고 다른 방향을 제시하세요. 참조가 약하거나 결과가 목표에서 벗어난 경우, 조용히 반복하지 말고 말하고 업로드를 요청하거나 방향을 전환하세요.
- 다단계 워크플로우를 계획하세요. 단계를 순서대로 나열하세요. 동일한 단계에 속하는 생성만 병렬화하세요.
- 마지막에 검토하세요. 의도한 생성이 실제로 실행되었고 요청된 것과 일치하는지 확인하세요. 최종 자산은
render_file로 렌더링하세요. - 도구 동작을 추측하지 마세요. 실제로 제공되지 않은 도구 매개변수, 반환 값 또는 환경 기능을 임의로 만들지 마세요. 추측보다는 확인하세요.
도구 선택하기
| 상황 | 호출 |
|---|---|
| 새 이미지, 소스 없음 | imagine_text_to_image (prompt + aspect_ratio와 함께) |
| 기존 이미지 하나 편집 / 스타일 변경 / 색상 변경 | imagine_image_to_image (prompt + 소스 경로와 함께) |
| 2개 이상의 참조 이미지를 하나로 결합 | imagine_reference_to_image (prompt + 소스 경로들과 함께) |
| 이전 결과 반복 | imagine_image_to_image (이전 경로와 함께) |
| 지명된 실제 인물 또는 그룹 | imagine_image_to_image (웹 검색 후 실제 참조 경로와 함께) |
| 처음부터 만든 일반 / 가상의 주제 | imagine_text_to_image |
| 새 비디오, 소스 없음 | imagine_text_to_video (prompt와 함께) |
| 정지 이미지 하나 애니메이션 | imagine_image_to_video (해당 정지 이미지의 경로와 함께) |
| 다중 참조 비디오 | imagine_reference_to_video (이미지 경로(들)과 함께) |
경험 법칙: 참조 없음 → text_to_; 참조 1개 → image_to_; 참조 2개 이상 → reference_to_*.
imagine_text_to_image
텍스트 프롬프트로 새 이미지를 생성합니다.
입력:
prompt(필수) - 원하는 이미지에 대한 전체 설명.aspect_ratio-1:1,3:4,4:3,2:3,3:2,9:16,16:9,21:9,5:2,50:11또는unknown중 하나. OG 공유 카드에는16:9를 사용하고 게임을 위한 맞춤public/x-banner.jpg생성 시 X 피드 배너에는50:11을 사용하세요 (모든 앱은x:game:image를 연결합니다. 게임만이 이를 위해 Imagine을 호출합니다 —og스킬 참조). 진정한 2:1 캔버스의 경우 xAI Images API를 호출하세요.
여러 변형을 생성하려면 별개의 프롬프트로 여러 imagine_text_to_image 호출을 만드세요. 이 도구는 n 또는 count 매개변수를 노출하지 않습니다.
imagine_image_to_image
기존 이미지 하나를 편집합니다.
입력 (이름은 실제 스키마를 따릅니다 — 일반적으로 단일 샌드박스 경로):
prompt(필수) - 변경할 내용 (편집 내용만 설명).- 소스 경로 필드 (필수) - 이전 생성 또는 다운로드로 반환된 샌드박스 경로.
aspect_ratio- 사용자가 명시적으로 비율 변경을 원할 때만 설정.
imagine_reference_to_image
2개 이상의 참조 경로로 하나의 이미지를 구성합니다.
입력:
prompt(필수).- 소스 경로 (필수) - 2개 이상의 샌드박스 경로.
aspect_ratio- 선택 사항.
단일 소스 편집의 경우 대신 imagine_image_to_image를 사용하세요.
imagine_text_to_video
텍스트 프롬프트만으로 새 비디오를 생성합니다 (소스 프레임 없음).
입력:
prompt(필수) - 짧은 현재 시제 샷 설명.duration/aspect_ratio/ 해상도 필드 (실제 스키마에 노출된 대로).
짧은 샷을 선호하세요. 아래 이미지-비디오와 동일한 프롬프트 제작 규칙을 따릅니다.
imagine_image_to_video
정지 이미지 하나를 비디오로 애니메이션합니다.
입력:
- 단일 소스 정지 이미지 경로 (필수).
prompt- 짧은 현재 시제 샷 (권장, 일부 변형에서는 필수).duration-6(기본값),10또는15(노출된 경우).aspect_ratio- 선택 사항. 하나의 이미지를 애니메이션할 때는 생략하여 소스 비율 유지.
짧은 샷을 선호하세요. 비디오를 하나의 긴 테이크가 아닌 계획된 짧은 클립 시퀀스로 구축하세요:
- 스토리를 샷으로 계획하세요 — 각각 하나의 비트.
- 더 적은 수의 긴 샷보다 더 많은 6초 샷을 선호하세요.
imagine_text_to_image/imagine_image_to_image로 각 샷의 소스 정지 이미지를 만드세요 (캐릭터 경로 일관성 유지).imagine_image_to_video+ 해당 정지 이미지 경로로 애니메이션하세요.
주요 동작:
- 프롬프트 제작: 하나의 짧고 생생한 순간을 현재 시제, 명확한 카메라 움직임과 함께 1-2문장으로.
- 최소하지만 흥미롭게: 하나의 명확한 주제와 하나의 단순한 동작 또는 카메라 움직임.
- 복잡한 소스? 주제를 고정하고 카메라만 움직이거나 더 간단한 샷으로 나누세요.
- 실제 인물: 참조 우선 — 확인된 참조에서 시작, 지명된 사람을 참조 없이 애니메이션하지 마세요.
- 요청하지 않으면 동일한 클립을 반복하지 마세요.
- 반환된 비디오 경로에 FFmpeg 스트림 복사로 다중 샷 타임라인을 조립하세요.
imagine_reference_to_video
프롬프트에 따라 하나 이상의 참조 이미지 경로로 비디오를 생성합니다. 목표가 깨끗한 첫 프레임일 때는 먼저 imagine_reference_to_image로 단일 정지 이미지를 구성한 다음 imagine_image_to_video를 선호하세요.
강력한 프롬프트 작성하기
대략 다음 순서로 설명하세요: 주제 -> 동작/포즈 -> 배경 -> 스타일 -> 구성 -> 조명/분위기 -> 주요 세부 사항.
- 구체적이고 명확하게; 가장 중요한 요소를 먼저 배치하세요.
- 제외할 것보다 포함할 것을 명시하세요.
- 프롬프트당 하나의 일관된 장면을 사용하세요.
aspect_ratio를 사용 사례에 맞추세요:9:16은 휴대폰/스토리,16:9는 배너/비디오 프레임 또는 OG 공유 카드,1:1은 아바타/아이콘.
실제 인물 및 참조
- 명백해 보이는 경우에도 먼저 웹을 검색하여 신원, 역할, 관계 또는 사건을 확인하세요.
- 디스크에 강력한 참조 이미지를 확보한 후 (사용자 업로드 또는 검색 → 샌드박스 경로), 해당 경로로
imagine_image_to_image를 호출하세요. 사용자가 업로드한 사진이 가장 좋습니다. - 적합한 참조가 없으면 약한 기반에서 생성하지 말고 사용자에게 업로드를 요청하세요.
결과 표시하기
render_file을 샌드박스file_path와 함께 호출하여 사용자가 채팅에서 이미지/비디오를 볼 수 있게 하세요.- 자체 품질 검사 및 스크립트의 경우 해당 경로에서
read_file/ 셸을 사용하세요.
게임 스프라이트 및 맵은 자체 파이프라인이 있습니다 — 이에 대해서는 generate2dsprite, video2dsprite 및 generate2dmap을 따르세요.
피해야 할 실패 모드
- 통합된 이름
imagine_image또는imagine_video호출 (사용 불가능). imagine_image_to_image/imagine_image_to_video에 리스트 전달 (단일 소스만 가능).- 도구가 반환한 적이 없는 파일 시스템 경로 임의 생성.
- 실제 생성 /
file_path없이 임의로 만든 경로에서 chroma/ffmpeg 실행.