curl --request POST \ --url https://api.apiyi.com/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "grok-imagine-image", "prompt": "A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography"}'
import requests
url = "https://api.apiyi.com/v1/images/generations"
payload = {
"model": "grok-imagine-image",
"prompt": "A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'grok-imagine-image',
prompt: 'A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography'
})
};
fetch('https://api.apiyi.com/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'grok-imagine-image',
'prompt' => 'A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"grok-imagine-image\",\n \"prompt\": \"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/images/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"grok-imagine-image\",\n \"prompt\": \"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography\"\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"grok-imagine-image\",\n \"prompt\": \"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography\"\n}"
response = http.request(request)
puts response.read_body
Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지
POST
/
v1
/
images
/
generations
Text-to-image: generate images from a text prompt
curl --request POST \ --url https://api.apiyi.com/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "grok-imagine-image", "prompt": "A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography"}'
import requests
url = "https://api.apiyi.com/v1/images/generations"
payload = {
"model": "grok-imagine-image",
"prompt": "A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'grok-imagine-image',
prompt: 'A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography'
})
};
fetch('https://api.apiyi.com/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'grok-imagine-image',
'prompt' => 'A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"grok-imagine-image\",\n \"prompt\": \"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/images/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"grok-imagine-image\",\n \"prompt\": \"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography\"\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"grok-imagine-image\",\n \"prompt\": \"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography\"\n}"
response = http.request(request)
puts response.read_body
🔒 기본적으로 공개되지 않음: Grok Imagine 2는 Default 그룹에 속하지 않습니다. 자체 Grok_imagine_Reverse 그룹에 속하며, 호출하기 전에 액세스 권한을 요청해야 합니다(이 페이지의 플레이그라운드 포함). 권한이 없으면 모든 호출이 503을 반환합니다.이 제품군의 콘텐츠 안전 정책은 플랫폼의 다른 모델과 상당히 다르며 일부 카테고리는 필터링되지 않습니다. 따라서 규정 준수 리스크를 제한하기 위해 액세스 권한을 선별적으로 부여합니다. 기존 고객은 누적 사용 금액이 $1,000 이상인 경우 사용 사례를 지원팀에 설명하여 활성화할 수 있습니다. 그 외의 사용자는 사용 사례와 적용 중인 콘텐츠 조정 제어를 설명하여 WeCom 지원팀을 통해 신청해야 합니다. 전체 절차는 Grok Imagine 2 개요 - 그룹 설정을 참조하십시오.
오른쪽의 대화형 플레이그라운드에서 엔드포인트를 직접 테스트할 수 있습니다. Authorization에 API Key를 입력하고(형식: Bearer sk-xxx), prompt을 입력한 다음 aspect_ratio / resolution을 선택하여 전송하십시오.
이 페이지를 사용해야 하는 경우: 프롬프트만으로 텍스트를 이미지로 생성하는 경우입니다. 이미지를 업로드하지 않습니다. 기존 이미지를 수정하거나 여러 이미지를 결합하려면 이미지 편집 엔드포인트를 사용하십시오.
⚠️ 이 엔드포인트로 참조 이미지를 전송하지 마십시오여기에 image / image_url / images을 전달해도 오류가 발생하지 않습니다. 200을 반환하고 프롬프트를 바탕으로 완전히 새로운 이미지를 생성하지만, 참조 이미지는 조용히 무시되며 과금은 계속됩니다.오류 신호가 없으므로 일반적으로 결과에 입력 이미지와 전혀 관련이 없다는 것을 누군가 알아차릴 때까지 이 문제가 드러나지 않습니다. 참조 이미지가 포함된 모든 워크플로는 /v1/images/edits을 사용해야 합니다.
⚠️ 잘못된 매개변수는 오류를 발생시키지 않습니다잘못된 aspect_ratio(예: 5:7), resolution(예: 1K, 1024x1024) 및 response_format(예: base64)은 모두 조용히 기본값으로 대체되며 이미지도 계속 반환됩니다. 출력이 예상과 다를 때는 먼저 매개변수 철자를 확인하십시오. resolution 값은 소문자 1k / 2k입니다.한 가지 예외로 resolution: "4k"은 503 model_service_unavailable를 반환합니다. 이는 채널이 중단된 것이 아니라 해당 티어가 지원되지 않는다는 의미입니다. 다시 시도해도 해결되지 않습니다.
모든 이미지 API는 동기식입니다. 비동기 작업 ID가 없으므로 클라이언트 연결이 끊기면 요청에 대한 과금이 진행되는 동안에도 결과를 잃게 됩니다. 1K는 약 9초, 2K는 약 15~17초가 걸리므로 클라이언트 타임아웃을 360초로 설정하십시오. 자세한 내용은 이미지 API 모범 사례를 참조하십시오.
from openai import OpenAIimport urllib.requestclient = OpenAI( api_key="sk-your-api-key", base_url="https://api.apiyi.com/v1", timeout=360.0 # image APIs are synchronous — allow plenty of time)resp = client.images.generate( model="grok-imagine-image", prompt="A photorealistic red wooden boat moored on a glassy alpine lake at dawn, " "mist over the water, snow-capped peaks behind, cinematic photography", n=1, # aspect_ratio / resolution are not standard OpenAI SDK fields — pass via extra_body extra_body={ "aspect_ratio": "16:9", "resolution": "1k", "response_format": "url" })# response_format defaults to url, returning a direct link (.jpg for 1K, .png for 2K)urllib.request.urlretrieve(resp.data[0].url, "out.jpg")
import fs from 'node:fs';const resp = await fetch('https://api.apiyi.com/v1/images/generations', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer sk-your-api-key' }, body: JSON.stringify({ model: 'grok-imagine-image', prompt: 'A serene Japanese garden with cherry blossoms, koi pond, golden hour', n: 2, // up to 10 per call, billed per image aspect_ratio: '4:3', resolution: '1k', response_format: 'url' }), // Node 18+ has no default timeout — use AbortSignal.timeout in production signal: AbortSignal.timeout(360000)});const data = await resp.json();// with n=2 the data array holds two entries — download eachfor (const [i, item] of data.data.entries()) { const img = await fetch(item.url); fs.writeFileSync(`out-${i}.jpg`, Buffer.from(await img.arrayBuffer()));}
// ⚠️ Demo only: a front-end key is exposed — use a backend proxy in productionconst resp = await fetch('https://api.apiyi.com/v1/images/generations', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer sk-your-api-key' }, body: JSON.stringify({ model: 'grok-imagine-image', prompt: 'a minimalist poster of a mountain at sunrise, flat vector style', aspect_ratio: '3:4', resolution: '1k', response_format: 'url' // url is far lighter than b64_json in a browser })});const data = await resp.json();document.querySelector('#preview').src = data.data[0].url;
Resolution tier. 1k is roughly 0.9-1.05 megapixels and returns JPEG;
2k is roughly 4.2-4.5 megapixels and returns PNG (5-6 MB per image).
Both tiers cost the same.
4k returns 503; other invalid values (such as 1K or 1024x1024) silently fall back to 1k.
Placeholder values — do not use for billing reconciliation.prompt_tokens is always
1000 x n, regardless of actual prompt length. Use the Console billing records instead.
Show child attributes
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"API易文档中心","description":"企业级专业稳定的AI大模型API中转站,一个令牌、无限模型。支持OpenAI、Claude、Gemini、DeepSeek、Qwen等 200+ 精选 AI 模型。","colors":{"primary":"#2563eb","light":"#3b82f6","dark":"#1d4ed8"},"logo":{"light":"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/light.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=4119ef17a74cc54be127f34578d8b5fa","dark":"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/dark.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=1f046ae9580247d96549ade642b5ecc4"},"favicon":"https://mintcdn.com/apiyillc/OMY6ItCc2mC1yzgA/logo/logo.webp?fit=max\u0026auto=format\u0026n=OMY6ItCc2mC1yzgA\u0026q=85\u0026s=62a7977ef801070e689df2d0291b9d13","api":{"openapi":["api-reference/nano-banana-2-generate-openapi.yaml","api-reference/nano-banana-2-edit-openapi.yaml","api-reference/nano-banana-2-generate-openapi-en.yaml","api-reference/nano-banana-2-edit-openapi-en.yaml","api-reference/nano-banana-pro-generate-openapi.yaml","api-reference/nano-banana-pro-edit-openapi.yaml","api-reference/nano-banana-pro-generate-openapi-en.yaml","api-reference/nano-banana-pro-edit-openapi-en.yaml","api-reference/gpt-image-2-all-generate-openapi.yaml","api-reference/gpt-image-2-all-edit-openapi.yaml","api-reference/gpt-image-2-all-generate-openapi-en.yaml","api-reference/gpt-image-2-all-edit-openapi-en.yaml","api-reference/gpt-image-2-all-chat-openapi.yaml","api-reference/gpt-image-2-all-chat-openapi-en.yaml","api-reference/gpt-image-2-vip-generate-openapi.yaml","api-reference/gpt-image-2-vip-edit-openapi.yaml","api-reference/gpt-image-2-vip-chat-openapi.yaml","api-reference/gpt-image-2-vip-generate-openapi-en.yaml","api-reference/gpt-image-2-vip-edit-openapi-en.yaml","api-reference/gpt-image-2-vip-chat-openapi-en.yaml"],"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required"}},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首页"},{"href":"https://imagen.apiyi.com","label":"AI出图"},{"href":"https://icover.ai","label":"AI视频"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 集成","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 开发者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"用户口碑 / Wall of Love","items":[{"label":"用户口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"seo":{"indexing":"all"},"icons":{"library":"lucide"},"banner":{"content":"🚀 **GPT Image 2.6 Sunburst 和 Flare 均已上线,支持 GIF 输出,低至 83 折(17% off) | Now Live**:[详情 Details](https://docs.apiyi.com/api-capabilities/gpt-image-2/gpt-image-2-6)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","aistudio"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[]},"languages":[{"language":"zh","href":""},{"language":"en","navbar":{"links":[{"href":"https://api.apiyi.com","label":"Home"},{"href":"https://imagen.apiyi.com","label":"AI Image"},{"href":"https://icover.ai","label":"AI Video"}],"primary":{"type":"button","label":"Console","href":"https://api.apiyi.com/account/profile"}},"href":"en"},{"language":"zh-Hant","banner":{"content":"本頁由程式自動轉換為繁體中文,用詞以台灣正體為準;如有歧義請以[簡體中文版](/)為準。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 整合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 開發者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"使用者口碑 / Wall of Love","items":[{"label":"使用者口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首頁"},{"href":"https://imagen.apiyi.com","label":"AI出圖"},{"href":"https://icover.ai","label":"AI影片"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"href":"zh-Hant"},{"language":"ja","banner":{"content":"このページは AI により翻訳されています。内容に相違がある場合は[English 版](/en)を正としてください。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI統合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI開発者キット(中国語)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"ユーザーの声 / Wall of Love","items":[{"label":"ユーザーの声(中国語)","href":"/wall-of-love"},{"label":"Wall of Love(英語)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"ホーム"},{"href":"https://imagen.apiyi.com","label":"AI画像生成"},{"href":"https://icover.ai","label":"AI動画生成"}],"primary":{"type":"button","label":"コンソール","href":"https://api.apiyi.com/account/profile"}},"href":"ja"},{"language":"ko","banner":{"content":"이 페이지는 AI로 번역되었습니다. 내용이 다를 경우 [English 버전](/en)을 기준으로 하십시오.","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 통합","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 개발자 키트(중국어)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"사용자 후기 / Wall of Love","items":[{"label":"사용자 후기(중국어)","href":"/wall-of-love"},{"label":"Wall of Love (영문)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"홈"},{"href":"https://imagen.apiyi.com","label":"AI 이미지 생성"},{"href":"https://icover.ai","label":"AI 동영상 생성"}],"primary":{"type":"button","label":"콘솔","href":"https://api.apiyi.com/account/profile"}},"href":"ko"},{"language":"ru","banner":{"content":"Эта страница переведена с помощью ИИ. При расхождениях ориентируйтесь на [английскую версию](/en).","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI-интеграция","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"Набор AI-разработчика (кит.)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"Отзывы пользователей / Wall of Love","items":[{"label":"Отзывы пользователей (на китайском)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"Главная"},{"href":"https://imagen.apiyi.com","label":"Генерация изображений"},{"href":"https://icover.ai","label":"Генерация видео"}],"primary":{"type":"button","label":"Консоль","href":"https://api.apiyi.com/account/profile"}},"href":"ru"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apiyillc","hasAudioNarration":false,"actualSubdomain":"apiyillc","customDomains":["docs.apiyi.com"],"gitSource":{"type":"github","owner":"pdmaker","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6af337d8a8d5ba2dc2ce6435","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"zh","tag":"首页","count":212},{"language":"en","tag":"Home","count":212},{"language":"ja","tag":"ホーム","count":212},{"language":"ko","tag":"홈","count":212},{"language":"ru","tag":"Главная","count":212},{"language":"zh-Hant","tag":"首頁","count":212},{"language":"zh","tag":"图片 API(官转)","count":83},{"language":"en","tag":"Image API (Official)","count":83},{"language":"ja","tag":"画像API(公式)","count":83},{"language":"ko","tag":"이미지 API (공식)","count":83},{"language":"ru","tag":"Image API (официальный)","count":83},{"language":"zh-Hant","tag":"圖片 API(官轉)","count":83},{"language":"zh","tag":"公告","count":79},{"language":"en","tag":"Announcements","count":79},{"language":"zh","tag":"AI风向标","count":76},{"language":"en","tag":"AI Radar","count":76},{"language":"zh","tag":"常见问题","count":63},{"language":"en","tag":"FAQ","count":63},{"language":"ja","tag":"FAQ","count":63},{"language":"ko","tag":"FAQ","count":63},{"language":"ru","tag":"FAQ","count":63},{"language":"zh-Hant","tag":"常見問題","count":63},{"language":"zh","tag":"使用场景","count":50},{"language":"en","tag":"Use Cases","count":50},{"language":"ja","tag":"活用例","count":50},{"language":"ko","tag":"활용 사례","count":50},{"language":"ru","tag":"Сценарии использования","count":50},{"language":"zh-Hant","tag":"使用場景","count":50},{"language":"zh","tag":"基础 API","count":47},{"language":"en","tag":"Basic API","count":47},{"language":"ja","tag":"基本API","count":47},{"language":"ko","tag":"기본 API","count":47},{"language":"ru","tag":"Базовый API","count":47},{"language":"zh-Hant","tag":"基礎 API","count":47},{"language":"zh","tag":"视频 API(官转)","count":35},{"language":"zh","tag":"模型价格","count":35},{"language":"en","tag":"Video API (Official)","count":35},{"language":"en","tag":"Model Pricing","count":35},{"language":"ja","tag":"動画API(公式)","count":35},{"language":"ja","tag":"モデル料金","count":35},{"language":"ko","tag":"동영상 API (공식)","count":35},{"language":"ko","tag":"모델 요금","count":35},{"language":"ru","tag":"Video API (официальный)","count":35},{"language":"ru","tag":"Цены на модели","count":35},{"language":"zh-Hant","tag":"影片 API(官轉)","count":35},{"language":"zh-Hant","tag":"模型價格","count":35},{"language":"zh","tag":"文本生成","count":27},{"language":"en","tag":"Text Generation","count":27},{"language":"ja","tag":"テキスト生成","count":27},{"language":"ko","tag":"텍스트 생성","count":27},{"language":"ru","tag":"Генерация текста","count":27},{"language":"zh-Hant","tag":"文本生成","count":27},{"language":"ja","tag":"課金とセキュリティ","count":17},{"language":"ko","tag":"결제 및 보안","count":17},{"language":"ru","tag":"Оплата и безопасность","count":17},{"language":"zh-Hant","tag":"充值與安全","count":17},{"language":"ja","tag":"NanoBananaベストプラクティス","count":15},{"language":"ko","tag":"NanoBanana 모범 사례","count":15},{"language":"ru","tag":"Лучшие практики NanoBanana","count":15},{"language":"zh-Hant","tag":"NanoBanana最佳實踐","count":15}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"models/models.css","content":".mp-layout{display:flex;gap:2.5rem;max-width:1400px;margin:0 auto;padding:2.5rem 1.5rem 4rem;font-size:15px;line-height:1.7;color:rgb(var(--gray-500, 113 115 119))}html.dark .mp-layout{color:rgb(var(--gray-400, 159 161 165))}.mp-rail{display:none}@media (min-width: 1024px){.mp-rail{display:block;width:13rem;flex-shrink:0}}.mp-rail-nav{position:sticky;top:9.25rem;font-size:0.875rem}.mp-rail-head{font-weight:600;margin:0 0 0.375rem;color:rgb(var(--gray-900, 23 25 29))}html.dark .mp-rail-head{color:rgb(var(--gray-200, 223 225 229))}.mp-rail-link{display:block;padding:0.22rem 0;color:rgb(var(--gray-500, 113 115 119));text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.mp-rail-link:hover{color:rgb(var(--primary, 37 99 235))}html.dark .mp-rail-link{color:rgb(var(--gray-400, 159 161 165))}html.dark .mp-rail-link:hover{color:rgb(var(--primary-light, 59 130 246))}.mp-rail-vendors{max-height:45vh;overflow-y:auto}.mp-mt{margin-top:1rem}.mp-content{min-width:0;flex:1}.mp-title{font-size:2rem;font-weight:700;letter-spacing:-0.02em;margin:0 0 0.5rem;color:rgb(var(--gray-900, 23 25 29))}html.dark .mp-title{color:#fff}.mp-desc{color:rgb(var(--gray-500, 113 115 119));margin:0 0 1.5rem}html.dark .mp-desc{color:rgb(var(--gray-400, 159 161 165))}.mp-content h2{font-size:1.375rem;font-weight:600;margin:2.75rem 0 1rem;padding-bottom:0.45rem;border-bottom:1px solid rgb(var(--gray-200, 223 225 229) / 0.7);color:rgb(var(--gray-900, 23 25 29));scroll-margin-top:12rem}@media (min-width: 1024px){.mp-content h2{scroll-margin-top:16.5rem}}html.dark .mp-content h2{border-color:rgb(255 255 255 / 0.1);color:#fff}.mp-content p{margin:0.75rem 0}.mp-content ul{margin:0.75rem 0;padding-left:1.4rem}.mp-content li{margin:0.4rem 0}.mp-content strong{color:rgb(var(--gray-900, 23 25 29))}html.dark .mp-content strong{color:#fff}.mp-content a{color:rgb(var(--primary, 37 99 235));text-decoration:none}.mp-content a:hover{text-decoration:underline}html.dark .mp-content a{color:rgb(var(--primary-light, 59 130 246))}.mp-content code{font-size:0.85em;background:rgb(var(--gray-100, 239 241 245) / 0.8);border:1px solid rgb(var(--gray-200, 223 225 229) / 0.7);padding:0.1em 0.35em;border-radius:0.375rem}html.dark .mp-content code{background:rgb(255 255 255 / 0.06);border-color:rgb(255 255 255 / 0.1)}.mp-content code.mp-ep-rec{color:rgb(var(--primary, 37 99 235));background:rgb(var(--primary, 37 99 235) / 0.08);border-color:rgb(var(--primary, 37 99 235) / 0.45);font-weight:600}html.dark .mp-content code.mp-ep-rec{color:rgb(var(--primary-light, 59 130 246));background:rgb(var(--primary-light, 59 130 246) / 0.14);border-color:rgb(var(--primary-light, 59 130 246) / 0.5)}.mp-content table{display:block;max-width:100%;overflow-x:auto;border-collapse:collapse;font-size:0.875rem;margin:1rem 0 1.5rem}.mp-content th{text-align:left;font-weight:500;color:rgb(var(--gray-500, 113 115 119));padding:0.55rem 1.25rem 0.55rem 0;border-bottom:1px solid rgb(var(--gray-200, 223 225 229) / 0.7);white-space:nowrap}.mp-content td{padding:0.55rem 1.25rem 0.55rem 0;border-bottom:1px solid rgb(var(--gray-200, 223 225 229) / 0.45);white-space:nowrap}html.dark .mp-content th{border-color:rgb(255 255 255 / 0.1);color:rgb(var(--gray-400, 159 161 165))}html.dark .mp-content td{border-color:rgb(255 255 255 / 0.07)}.mp-search{display:contents}.mp-search-bar{position:sticky;top:5rem;z-index:20;margin:0 0 1.75rem;background:rgb(var(--background-light, 255 255 255));padding:0.75rem 0 0.85rem;box-shadow:0 10px 14px -10px rgb(var(--gray-950, 11 13 17) / 0.28)}@media (min-width: 1024px){.mp-search-bar{top:9.25rem}}html.dark .mp-search-bar{background:rgb(var(--background-dark, 10 11 16));box-shadow:0 8px 12px -10px rgb(0 0 0 / 0.7)}.mp-search-label{margin:0 0 0.5rem;padding-left:0.6rem;border-left:3px solid rgb(var(--primary, 37 99 235));font-size:0.9rem;font-weight:600;line-height:1.4;color:rgb(var(--primary, 37 99 235))}html.dark .mp-search-label{border-left-color:rgb(var(--primary-light, 59 130 246));color:rgb(var(--primary-light, 59 130 246))}.mp-search-input{width:100%;box-sizing:border-box;border:1px solid rgb(var(--gray-400, 159 161 165) / 0.3);border-radius:0.75rem;padding:0.7rem 1rem 0.7rem 2.65rem;font-size:0.9rem;background-color:rgb(var(--background-light, 255 255 255));background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%23717377' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E\");background-repeat:no-repeat;background-position:0.9rem center;color:rgb(var(--gray-900, 23 25 29));outline:none;transition:border-color 0.15s ease, background-color 0.15s ease, box-shadow 0.15s ease}.mp-search-input::placeholder{color:rgb(var(--gray-500, 113 115 119))}.mp-search-input:hover{border-color:rgb(var(--gray-600, 81 83 87) / 0.3)}.mp-search-input:focus{border-color:rgb(var(--primary, 37 99 235));box-shadow:0 0 0 3px rgb(var(--primary, 37 99 235) / 0.16)}html.dark .mp-search-input{background-color:rgb(var(--background-dark, 10 11 16));background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%239fa1a5' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E\");border-color:rgb(var(--gray-600, 81 83 87) / 0.3);color:rgb(var(--gray-100, 239 241 245))}html.dark .mp-search-input::placeholder{color:rgb(255 255 255 / 0.5)}html.dark .mp-search-input:hover{border-color:rgb(var(--gray-500, 113 115 119) / 0.35)}html.dark .mp-search-input:focus{border-color:rgb(var(--primary-light, 59 130 246));box-shadow:0 0 0 3px rgb(var(--primary-light, 59 130 246) / 0.22)}.mp-search-meta{font-size:0.75rem;color:rgb(var(--gray-500, 113 115 119));margin:0.75rem 0 0.25rem}.mp-search-empty{font-size:0.875rem;color:rgb(var(--gray-500, 113 115 119));margin-top:0.75rem}html.dark .mp-search-meta,html.dark .mp-search-empty{color:rgb(var(--gray-400, 159 161 165))}.mp-mono{font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:0.8125rem}@media (min-width: 1024px){.mp-jump{display:none}}"},{"filePath":"styles/agent-prompt.css","content":"div.prompt{border:1.5px solid rgb(var(--primary, 37 99 235) / 0.35);background:rgb(var(--primary, 37 99 235) / 0.035);padding:1.25rem 1.25rem 1rem;row-gap:0.75rem}html.dark div.prompt{border-color:rgb(var(--primary-light, 59 130 246) / 0.4);background:rgb(var(--primary-light, 59 130 246) / 0.06)}div.prompt [data-component-part=\"prompt-content-wrapper\"]{width:100%}div.prompt [data-component-part=\"prompt-actions-wrapper\"]{width:100%;justify-content:flex-end}div.prompt [data-component-part=\"prompt-description\"]{flex:1;font-size:14px;line-height:1.65}div.prompt [data-component-part=\"prompt-description\"]>div>*{margin:0}div.prompt [data-component-part=\"prompt-description\"]>div>*+*{margin-top:0.6rem}div.prompt [data-component-part=\"prompt-description\"] strong{font-size:15px;font-weight:650;color:rgb(var(--gray-900, 23 25 29))}html.dark div.prompt [data-component-part=\"prompt-description\"] strong{color:#fff}div.prompt [data-component-part=\"prompt-description\"]>div>*+p{color:rgb(var(--gray-600, 80 82 86))}html.dark div.prompt [data-component-part=\"prompt-description\"]>div>*+p{color:rgb(var(--gray-400, 159 161 165))}div.prompt [data-component-part=\"prompt-description\"] code{font-size:0.85em;background:rgb(var(--gray-100, 239 241 245) / 0.9);border:1px solid rgb(var(--gray-200, 223 225 229) / 0.7);padding:0.05em 0.35em;border-radius:0.375rem}html.dark div.prompt [data-component-part=\"prompt-description\"] code{background:rgb(255 255 255 / 0.06);border-color:rgb(255 255 255 / 0.1)}div.prompt [data-component-part=\"prompt-description\"] blockquote{margin:0;padding:0.75rem 0.9rem;font-style:normal;border:1px dashed rgb(var(--gray-300, 191 193 197));border-radius:0.6rem;background:rgb(var(--background-light, 255 255 255));font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:12.5px;line-height:1.6;color:rgb(var(--gray-600, 80 82 86));overflow-wrap:anywhere;-webkit-mask-image:linear-gradient(to bottom, #000 70%, transparent 100%);mask-image:linear-gradient(to bottom, #000 70%, transparent 100%)}div.prompt [data-component-part=\"prompt-description\"] blockquote p,div.prompt [data-component-part=\"prompt-description\"] blockquote ol{margin:0}div.prompt [data-component-part=\"prompt-description\"] blockquote li{padding:0}div.prompt [data-component-part=\"prompt-description\"] blockquote>*+*{margin-top:0.5rem}div.prompt [data-component-part=\"prompt-description\"] blockquote code{background:none;border:0;padding:0;font-size:1em}div.prompt [data-component-part=\"prompt-description\"] blockquote a{color:inherit;text-decoration:none;pointer-events:none}html.dark div.prompt [data-component-part=\"prompt-description\"] blockquote{border-color:rgb(255 255 255 / 0.15);background:rgb(var(--background-dark, 13 13 13));color:rgb(var(--gray-400, 159 161 165))}div.prompt [data-component-part=\"prompt-action-copy-button\"]{padding:0.6rem 1.25rem;font-size:14px;line-height:20px;font-weight:600;border-radius:0.65rem;gap:0.45rem;box-shadow:0 1px 2px rgb(0 0 0 / 0.08), 0 4px 12px rgb(var(--primary, 37 99 235) / 0.25)}div.prompt [data-component-part=\"prompt-action-copy-button\"]::before{content:\"\";width:16px;height:16px;flex-shrink:0;background:currentColor;-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center / contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center / contain no-repeat}div.prompt [data-component-part=\"prompt-action-copy-button\"] svg{width:12px;height:12px}@media (max-width: 640px){div.prompt [data-component-part=\"prompt-actions-wrapper\"]>*{flex:1}}"}],"page":{"pagePath":"ko/api-capabilities/grok-imagine-image/text-to-image","slug":"/ko/api-capabilities/grok-imagine-image/text-to-image","pageMetadata":{"title":"텍스트-이미지 API 레퍼런스","description":"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지","openapi":"api-reference/grok-imagine-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image/text-to-image"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`🔒 기본적으로 공개되지 않음`}),`: Grok Imagine 2는 `,_jsx(_components.code,{children:`Default`}),` 그룹에 속하지 않습니다. 자체 `,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`Grok_imagine_Reverse`}),` 그룹`]}),`에 속하며, 호출하기 전에 액세스 권한을 요청해야 합니다(이 페이지의 플레이그라운드 포함). 권한이 없으면 모든 호출이 `,_jsx(_components.code,{children:`503`}),`을 반환합니다.`]}),_jsxs(_components.p,{children:[`이 제품군의 콘텐츠 안전 정책은 플랫폼의 다른 모델과 상당히 다르며 일부 카테고리는 필터링되지 않습니다. 따라서 규정 준수 리스크를 제한하기 위해 액세스 권한을 선별적으로 부여합니다. 기존 고객은 누적 사용 금액이 $1,000 이상인 경우 사용 사례를 지원팀에 설명하여 활성화할 수 있습니다. 그 외의 사용자는 사용 사례와 적용 중인 콘텐츠 조정 제어를 설명하여 `,_jsx(_components.a,{href:`https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec`,children:`WeCom 지원팀`}),`을 통해 신청해야 합니다. 전체 절차는 `,_jsx(_components.a,{href:`/ko/api-capabilities/grok-imagine-image/overview#group-setup`,children:`Grok Imagine 2 개요 - 그룹 설정`}),`을 참조하십시오.`]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`오른쪽의 대화형 플레이그라운드에서 엔드포인트를 직접 테스트할 수 있습니다. `,_jsx(_components.strong,{children:`Authorization`}),`에 API Key를 입력하고(형식: `,_jsx(_components.code,{children:`Bearer sk-xxx`}),`), `,_jsx(_components.code,{children:`prompt`}),`을 입력한 다음 `,_jsx(_components.code,{children:`aspect_ratio`}),` / `,_jsx(_components.code,{children:`resolution`}),`을 선택하여 전송하십시오.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`이 페이지를 사용해야 하는 경우`}),`: 프롬프트만으로 텍스트를 이미지로 생성하는 경우입니다. 이미지를 업로드하지 않습니다. 기존 이미지를 수정하거나 여러 이미지를 결합하려면 `,_jsx(_components.a,{href:`/ko/api-capabilities/grok-imagine-image/image-edit`,children:`이미지 편집 엔드포인트`}),`를 사용하십시오.`]})}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`⚠️ 이 엔드포인트로 참조 이미지를 전송하지 마십시오`})}),_jsxs(_components.p,{children:[`여기에 `,_jsx(_components.code,{children:`image`}),` / `,_jsx(_components.code,{children:`image_url`}),` / `,_jsx(_components.code,{children:`images`}),`을 전달해도 `,_jsx(_components.strong,{children:`오류가 발생하지 않습니다`}),`. 200을 반환하고 프롬프트를 바탕으로 완전히 새로운 이미지를 생성하지만, `,_jsx(_components.strong,{children:`참조 이미지는 조용히 무시되며 과금은 계속됩니다`}),`.`]}),_jsxs(_components.p,{children:[`오류 신호가 없으므로 일반적으로 결과에 입력 이미지와 전혀 관련이 없다는 것을 누군가 알아차릴 때까지 이 문제가 드러나지 않습니다. `,_jsxs(_components.strong,{children:[`참조 이미지가 포함된 모든 워크플로는 `,_jsx(_components.a,{href:`/ko/api-capabilities/grok-imagine-image/image-edit`,children:_jsx(_components.code,{children:`/v1/images/edits`})}),`을 사용해야 합니다.`]})]})]}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`⚠️ 잘못된 매개변수는 오류를 발생시키지 않습니다`})}),_jsxs(_components.p,{children:[`잘못된 `,_jsx(_components.code,{children:`aspect_ratio`}),`(예: `,_jsx(_components.code,{children:`5:7`}),`), `,_jsx(_components.code,{children:`resolution`}),`(예: `,_jsx(_components.code,{children:`1K`}),`, `,_jsx(_components.code,{children:`1024x1024`}),`) 및 `,_jsx(_components.code,{children:`response_format`}),`(예: `,_jsx(_components.code,{children:`base64`}),`)은 모두 `,_jsx(_components.strong,{children:`조용히 기본값으로 대체`}),`되며 이미지도 계속 반환됩니다. 출력이 예상과 다를 때는 먼저 매개변수 철자를 확인하십시오. `,_jsx(_components.code,{children:`resolution`}),` 값은 소문자 `,_jsx(_components.code,{children:`1k`}),` / `,_jsx(_components.code,{children:`2k`}),`입니다.`]}),_jsxs(_components.p,{children:[`한 가지 예외로 `,_jsx(_components.code,{children:`resolution: \"4k\"`}),`은 `,_jsx(_components.code,{children:`503 model_service_unavailable`}),`를 반환합니다. 이는 채널이 중단된 것이 아니라 `,_jsx(_components.strong,{children:`해당 티어가 지원되지 않는다는 의미`}),`입니다. 다시 시도해도 해결되지 않습니다.`]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`모든 이미지 API는 `,_jsx(_components.strong,{children:`동기식`}),`입니다. 비동기 작업 ID가 없으므로 클라이언트 연결이 끊기면 요청에 대한 과금이 진행되는 동안에도 결과를 잃게 됩니다. 1K는 약 9초, 2K는 약 15~17초가 걸리므로 `,_jsx(_components.strong,{children:`클라이언트 타임아웃을 360초로 설정하십시오`}),`. 자세한 내용은 `,_jsx(_components.a,{href:`/ko/api-capabilities/image-api-best-practices`,children:`이미지 API 모범 사례`}),`를 참조하십시오.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`코드-예시`,children:`코드 예시`}),`\n`,_jsx(Heading,{level:`3`,id:`python-openai-sdk`,children:`Python (OpenAI SDK)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`24`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`24`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` openai `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` OpenAI`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` urllib.request`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` OpenAI(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sk-your-api-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` base_url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.apiyi.com/v1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`360.0`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # image APIs are synchronous — allow plenty of time`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`resp `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.images.generate(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` model`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"grok-imagine-image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` prompt`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, \"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"mist over the water, snow-capped peaks behind, cinematic photography\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # aspect_ratio / resolution are not standard OpenAI SDK fields — pass via extra_body`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` extra_body`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"aspect_ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1k\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"response_format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"url\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# response_format defaults to url, returning a direct link (.jpg for 1K, .png for 2K)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`urllib.request.urlretrieve(resp.data[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`].url, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"out.jpg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`python-원시-요청`,children:`Python (원시 요청)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`25`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`25`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` base64`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sk-your-api-key\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.apiyi.com/v1/images/generations\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"grok-imagine-image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Cyberpunk city on a rainy night, neon signage close-up, cinematic lighting\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"n\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"aspect_ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2k\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# 2k returns PNG at 5-6 MB per image`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"response_format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"b64_json\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`360`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # 2K takes 15-17s and longer at peak; 60s causes spurious timeouts`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`).json()`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# b64_json is raw base64 with no data: prefix — decode and write directly`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`with`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` open`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"out.png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"wb\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`as`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` f:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` f.write(base64.b64decode(response[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"b64_json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]))`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`curl`,children:`cURL`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.apiyi.com/v1/images/generations\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk-your-api-key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"grok-imagine-image-quality\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"An orange tabby cat wearing sunglasses at a seaside bar, photorealistic, warm sunset tones\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"n\": 1,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"aspect_ratio\": \"16:9\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution\": \"1k\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"response_format\": \"url\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`node-js-네이티브-fetch`,children:`Node.js (네이티브 fetch)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`27`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`27`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` fs`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'node:fs'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` resp`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.apiyi.com/v1/images/generations'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer sk-your-api-key'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` model:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'grok-imagine-image'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` prompt:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'A serene Japanese garden with cherry blossoms, koi pond, golden hour'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` n:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// up to 10 per call, billed per image`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` aspect_ratio:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '4:3'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resolution:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '1k'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response_format:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'url'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Node 18+ has no default timeout — use AbortSignal.timeout in production`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` signal:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` AbortSignal`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`timeout`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`360000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resp`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// with n=2 the data array holds two entries — download each`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`i`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`item`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`of`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`entries`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` img`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`item`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` fs`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`writeFileSync`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`out-\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\".jpg`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Buffer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` img`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`arrayBuffer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()));`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`브라우저-javascript`,children:`브라우저 JavaScript`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`18`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`18`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// ⚠️ Demo only: a front-end key is exposed — use a backend proxy in production`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` resp`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.apiyi.com/v1/images/generations'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer sk-your-api-key'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` model:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'grok-imagine-image'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` prompt:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'a minimalist poster of a mountain at sunrise, flat vector style'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` aspect_ratio:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '3:4'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resolution:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '1k'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response_format:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'url'`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // url is far lighter than b64_json in a browser`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resp`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`document`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`querySelector`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'#preview'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`).`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`src`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`].`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`매개변수-참조`,children:`매개변수 참조`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`매개변수`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`필수`}),_jsx(_components.th,{children:`기본값`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`model`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`—`}),_jsxs(_components.td,{children:[`이미지당 $0.02인 `,_jsx(_components.code,{children:`grok-imagine-image`}),` 또는 이미지당 $0.045인 `,_jsx(_components.code,{children:`grok-imagine-image-quality`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`prompt`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`영어 또는 중국어로 작성하는 prompt입니다. 주제, 장면, 스타일 및 조명을 설명합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`n`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`❌`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1`})}),_jsxs(_components.td,{children:[`호출당 이미지 수이며, `,_jsx(_components.strong,{children:`1-10`}),` 범위입니다. 이미지별로 과금됩니다. `,_jsx(_components.code,{children:`0`}),`은 `,_jsx(_components.code,{children:`1`}),`이 되며, `,_jsx(_components.code,{children:`≥11`}),`은 400을 반환합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`aspect_ratio`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`❌`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1:1`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1:1`}),` / `,_jsx(_components.code,{children:`16:9`}),` / `,_jsx(_components.code,{children:`9:16`}),` / `,_jsx(_components.code,{children:`4:3`}),` / `,_jsx(_components.code,{children:`3:4`}),`입니다. 그 외의 값은 오류 없이 `,_jsx(_components.code,{children:`1:1`}),`로 대체됩니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resolution`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`❌`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1k`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1k`}),`은 직접 링크를 반환하며(JPEG, 약 1 MP), `,_jsx(_components.code,{children:`2k`}),`는 PNG, 약 4.2-4.5 MP입니다. `,_jsx(_components.strong,{children:`가격은 동일`}),`하며, `,_jsx(_components.code,{children:`4k`}),`은 503을 반환합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`response_format`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`❌`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`url`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`url`}),`은 직접 링크를 반환하고, `,_jsx(_components.code,{children:`b64_json`}),`은 원시 base64를 반환합니다(`,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`data:`}),` 접두사 없음`]}),`)`]})]})]})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`종횡비별 실제 출력 픽셀:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`aspect_ratio`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`1k`})}),_jsx(_components.th,{children:_jsx(_components.code,{children:`2k`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1:1`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1024x1024`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2048x2048`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`16:9`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1280x720`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2816x1584`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`9:16`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`720x1280`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1584x2816`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`4:3`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1152x864`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2368x1776`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3:4`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`864x1152`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1776x2368`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`seed`}),`은 지원되지 않습니다(오류 없이 허용되지만 효과가 없으므로 결과를 재현할 수 없습니다). mask 인페인팅도 지원되지 않습니다. `,_jsx(_components.code,{children:`size`}),` / `,_jsx(_components.code,{children:`quality`}),` / `,_jsx(_components.code,{children:`style`}),`과 같은 OpenAI 스타일 필드는 오류 없이 무시됩니다.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`응답-형식`,children:`응답 형식`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://apac.ossforai.com/2026/08/12/1ab87d04-3637-464f-bafd-f026cac05dd3.jpg\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"output_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`응답 필드의 주의사항`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`각 `,_jsx(_components.code,{children:`data[]`}),` 항목에는 `,_jsx(_components.code,{children:`response_format`}),`에 따라 `,_jsx(_components.code,{children:`url`}),` 또는 `,_jsx(_components.code,{children:`b64_json`}),` 중 하나만 포함되며, 둘 다 포함되지는 않습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`revised_prompt`}),`은 반환되지 않으며`]}),`, `,_jsx(_components.code,{children:`respect_moderation`}),` / `,_jsx(_components.code,{children:`model`}),`도 반환되지 않습니다. 해당 항목이 존재한다고 가정하지 마십시오.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`b64_json`}),`은 `,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`data:image/...;base64,`}),` 접두사가 없는 원시 base64`]}),`이므로 직접 디코딩하십시오.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`created`}),`은 항상 `,_jsx(_components.code,{children:`0`}),`이며 타임스탬프로 사용할 수 없습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`n > 1`}),`을 사용하는 경우 `,_jsx(_components.code,{children:`data`}),` 배열에는 여러 항목이 포함되므로 `,_jsx(_components.code,{children:`data[0]`}),`만 읽지 마십시오.`]}),`\n`]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`usage`}),`은 대사에 사용할 수 없습니다`]}),`. 실제 prompt 길이와 관계없이 `,_jsx(_components.code,{children:`prompt_tokens`}),`은 항상 `,_jsx(_components.code,{children:`1000 x n`}),`입니다. 이 제품군은 이미지당 고정 요율($0.02 / $0.045)로 과금되므로 실제 청구 금액은 APIYI 콘솔의 과금 기록을 사용하십시오.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"텍스트-이미지 API 레퍼런스","description":"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지","openapi":"api-reference/grok-imagine-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image/text-to-image"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"코드 예시","slug":"코드-예시","depth":2,"children":[{"title":"Python (OpenAI SDK)","slug":"python-openai-sdk","depth":3,"children":[]},{"title":"Python (원시 요청)","slug":"python-원시-요청","depth":3,"children":[]},{"title":"cURL","slug":"curl","depth":3,"children":[]},{"title":"Node.js (네이티브 fetch)","slug":"node-js-네이티브-fetch","depth":3,"children":[]},{"title":"브라우저 JavaScript","slug":"브라우저-javascript","depth":3,"children":[]}]},{"title":"매개변수 참조","slug":"매개변수-참조","depth":2,"children":[]},{"title":"응답 형식","slug":"응답-형식","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"generateGrokImagineTextToImage","summary":"Text-to-image: generate images from a text prompt","description":"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지","tags":["Text-to-Image"],"security":["765d1ef5-e2d4-4e00-9185-52fd9c18d963"],"requestBody":"d5a63fce-c626-4d80-8594-771b3b16875a","responses":{"200":"285a33f3-24c7-43bf-9d47-eea48bd34ae8","400":"95093d03-58b1-4116-a084-503ddd1f3484","401":"a0f6a268-3993-42c6-83fb-02dc1d2dd7f0","429":"bd723c0b-859c-44d4-8cfb-cfc08e8c3f99","503":"31ac187a-9138-4a4d-8380-1ade0d6e8f76"},"method":"post","type":"path","servers":["1f6747ef-596e-44a1-a15e-de97e3e83834"],"path":"/v1/images/generations","baseUrlOptions":["https://api.apiyi.com"],"title":"Text-to-image: generate images from a text prompt","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","prompt"],"properties":{"model":{"type":"string","description":"Model ID. The quality variant delivers higher fidelity at a higher price","enum":["grok-imagine-image","grok-imagine-image-quality"],"default":"grok-imagine-image","isRequired":true,"uniqueKey":"model","typeLabel":"enum\u003cstring>"},"prompt":{"type":"string","description":"Prompt, English or Chinese. Describe subject, scene, style and lighting in detail","example":"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"n":{"type":"integer","description":"Number of images, 1-10. Values of 11 or above return 400; 0 is silently treated as 1","minimum":1,"maximum":10,"default":1,"example":1,"uniqueKey":"n","typeLabel":"integer"},"aspect_ratio":{"type":"string","description":"Output aspect ratio. Actual pixel dimensions per resolution tier:\n\n| Aspect ratio | `1k` | `2k` |\n|---|---|---|\n| `1:1` | 1024x1024 | 2048x2048 |\n| `16:9` | 1280x720 | 2816x1584 |\n| `9:16` | 720x1280 | 1584x2816 |\n| `4:3` | 1152x864 | 2368x1776 |\n| `3:4` | 864x1152 | 1776x2368 |\n\nValues outside this enum do not raise an error — they silently fall back to `1:1`.\n","enum":["1:1","16:9","9:16","4:3","3:4"],"default":"1:1","example":"16:9","uniqueKey":"aspect_ratio","typeLabel":"enum\u003cstring>"},"resolution":{"type":"string","description":"Resolution tier. `1k` is roughly 0.9-1.05 megapixels and returns JPEG;\n`2k` is roughly 4.2-4.5 megapixels and returns PNG (5-6 MB per image).\n**Both tiers cost the same.**\n\n`4k` returns 503; other invalid values (such as `1K` or `1024x1024`) silently fall back to `1k`.\n","enum":["1k","2k"],"default":"1k","example":"1k","uniqueKey":"resolution","typeLabel":"enum\u003cstring>"},"response_format":{"type":"string","description":"Response format. `url` returns a direct image link (no signed query params);\n`b64_json` returns a raw base64 string (**without** the `data:` prefix).\n\nInvalid values silently fall back to the default `url`.\n","enum":["url","b64_json"],"default":"url","example":"url","uniqueKey":"response_format","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"grok-imagine-image","prompt":"A photorealistic red wooden boat moored on a glassy alpine lake at dawn, mist over the water, snow-capped peaks behind, cinematic photography","n":1,"aspect_ratio":"16:9","resolution":"1k","response_format":"url"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"285a33f3-24c7-43bf-9d47-eea48bd34ae8":{"description":"Images generated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"created":{"type":"integer","description":"Creation timestamp. Always 0 for this model — do not use it for timing","example":0,"uniqueKey":"created","typeLabel":"integer"},"data":{"type":"array","description":"Array of image results, length equals the requested `n`","items":{"type":"object","properties":{"url":{"type":"string","description":"Direct image link, returned when `response_format=url`. .jpg for 1K, .png for 2K","example":"https://apac.ossforai.com/2026/08/12/1ab87d04-3637-464f-bafd-f026cac05dd3.jpg","uniqueKey":"data.items.[INDEX].url","typeLabel":"string"},"b64_json":{"type":"string","description":"Raw base64 image data, returned when `response_format=b64_json` (no data: prefix)","uniqueKey":"data.items.[INDEX].b64_json","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"},"usage":{"type":"object","description":"**Placeholder values — do not use for billing reconciliation.** `prompt_tokens` is always\n`1000 x n`, regardless of actual prompt length. Use the Console billing records instead.\n","properties":{"prompt_tokens":{"type":"integer","example":1000,"uniqueKey":"usage.prompt_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","example":1000,"uniqueKey":"usage.total_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","example":0,"uniqueKey":"usage.output_tokens","typeLabel":"integer"}},"uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"created":0,"data":[{"url":"https://apac.ossforai.com/2026/08/12/1ab87d04-3637-464f-bafd-f026cac05dd3.jpg","b64_json":"\u003cstring>"}],"usage":{"prompt_tokens":1000,"total_tokens":1000,"output_tokens":0}}}},"exampleType":"generated"}},"exampleType":"generated"},"95093d03-58b1-4116-a084-503ddd1f3484":{"description":"Invalid parameters, or prompt blocked by content moderation (both share the `invalid_request` code)","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a0f6a268-3993-42c6-83fb-02dc1d2dd7f0":{"description":"Unauthorized - invalid API Key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"bd723c0b-859c-44d4-8cfb-cfc08e8c3f99":{"description":"Rate limit exceeded or insufficient balance","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"31ac187a-9138-4a4d-8380-1ade0d6e8f76":{"description":"Unsupported parameter tier (e.g. `resolution: 4k`), or no available channel in the current Group","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"765d1ef5-e2d4-4e00-9185-52fd9c18d963":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API Key created in the APIYI Console","scopes":[]}}},"servers":{"1f6747ef-596e-44a1-a15e-de97e3e83834":{"url":"https://api.apiyi.com","description":"Primary endpoint"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API Key created in the APIYI Console","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API Key created in the APIYI Console","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/grok-imagine-image-generate-openapi-en.yaml"},"subdomain":"apiyillc","siteName":"API易文档中心","title":"텍스트-이미지 API 레퍼런스 - API易文档中心","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"zh":{"href":"/api-capabilities/grok-imagine-image/text-to-image","matchLevel":1},"en":{"href":"/en/api-capabilities/grok-imagine-image/text-to-image","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/api-capabilities/grok-imagine-image/text-to-image","matchLevel":1},"ja":{"href":"/ja/api-capabilities/grok-imagine-image/text-to-image","matchLevel":1},"ko":{"href":"/ko/api-capabilities/grok-imagine-image/text-to-image","matchLevel":0},"ru":{"href":"/ru/api-capabilities/grok-imagine-image/text-to-image","matchLevel":1}}},"lastModified":"2026-11-09T08:49:14.739Z","originalFileLocation":"ko/api-capabilities/grok-imagine-image/text-to-image.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지\">\u003cmeta data-mint-head name=\"application-name\" content=\"API易文档中心\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"텍스트-이미지 API 레퍼런스 - API易文档中心\">\u003cmeta data-mint-head property=\"og:description\" content=\"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API易文档中心\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apiyillc.mintlify.site/_mintlify/api/og/v2?division=Grok+Imagine+%EB%A6%AC%EB%B2%84%EC%8A%A4+%EC%9D%B4%EB%AF%B8%EC%A7%80+%EC%83%9D%EC%84%B1+%EB%B0%8F+%ED%8E%B8%EC%A7%91\u0026amp;title=%ED%85%8D%EC%8A%A4%ED%8A%B8-%EC%9D%B4%EB%AF%B8%EC%A7%80+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4\u0026amp;description=Grok+Imagine+2+%ED%85%8D%EC%8A%A4%ED%8A%B8-%EC%9D%B4%EB%AF%B8%EC%A7%80+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4+%EB%B0%8F+%EC%8B%A4%EC%8B%9C%EA%B0%84+%ED%85%8C%EC%8A%A4%ED%8A%B8+%E2%80%94+prompt%EB%A7%8C+%EC%82%AC%EC%9A%A9%ED%95%9C+%EC%83%9D%EC%84%B1%2C+5%EA%B0%80%EC%A7%80+%EA%B0%80%EB%A1%9C%EC%84%B8%EB%A1%9C+%EB%B9%84%EC%9C%A8%2C+1K%2F2K+%EB%93%B1%EA%B8%89%2C+%ED%98%B8%EC%B6%9C%EB%8B%B9+%EC%B5%9C%EB%8C%80+10%EA%B0%9C+%EC%9D%B4%EB%AF%B8%EC%A7%80\u0026amp;theme=84509e4a5d1cb12fd162de92\u0026amp;signature=d93dee17fb975858198c89e9daa9b9d578622e5bed7b2e92534fe87aa90a0a1e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"텍스트-이미지 API 레퍼런스 - API易文档中心\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apiyillc.mintlify.site/_mintlify/api/og/v2?division=Grok+Imagine+%EB%A6%AC%EB%B2%84%EC%8A%A4+%EC%9D%B4%EB%AF%B8%EC%A7%80+%EC%83%9D%EC%84%B1+%EB%B0%8F+%ED%8E%B8%EC%A7%91\u0026amp;title=%ED%85%8D%EC%8A%A4%ED%8A%B8-%EC%9D%B4%EB%AF%B8%EC%A7%80+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4\u0026amp;description=Grok+Imagine+2+%ED%85%8D%EC%8A%A4%ED%8A%B8-%EC%9D%B4%EB%AF%B8%EC%A7%80+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4+%EB%B0%8F+%EC%8B%A4%EC%8B%9C%EA%B0%84+%ED%85%8C%EC%8A%A4%ED%8A%B8+%E2%80%94+prompt%EB%A7%8C+%EC%82%AC%EC%9A%A9%ED%95%9C+%EC%83%9D%EC%84%B1%2C+5%EA%B0%80%EC%A7%80+%EA%B0%80%EB%A1%9C%EC%84%B8%EB%A1%9C+%EB%B9%84%EC%9C%A8%2C+1K%2F2K+%EB%93%B1%EA%B8%89%2C+%ED%98%B8%EC%B6%9C%EB%8B%B9+%EC%B5%9C%EB%8C%80+10%EA%B0%9C+%EC%9D%B4%EB%AF%B8%EC%A7%80\u0026amp;theme=84509e4a5d1cb12fd162de92\u0026amp;signature=d93dee17fb975858198c89e9daa9b9d578622e5bed7b2e92534fe87aa90a0a1e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"API易文档中心\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/api-capabilities/grok-imagine-image/text-to-image.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.apiyi.com/api-capabilities/grok-imagine-image/text-to-image\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.apiyi.com/en/api-capabilities/grok-imagine-image/text-to-image\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.apiyi.com/zh-Hant/api-capabilities/grok-imagine-image/text-to-image\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.apiyi.com/ru/api-capabilities/grok-imagine-image/text-to-image\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.apiyi.com/api-capabilities/grok-imagine-image/text-to-image\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apiyi.com/#organization\",\"name\":\"API易文档中心\",\"url\":\"https://docs.apiyi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/light.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=4119ef17a74cc54be127f34578d8b5fa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apiyi.com#website\",\"name\":\"API易文档中心\",\"url\":\"https://docs.apiyi.com\",\"publisher\":{\"@id\":\"https://docs.apiyi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image#webpage\",\"url\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image\",\"name\":\"텍스트-이미지 API 레퍼런스\",\"description\":\"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지\",\"dateModified\":\"2026-11-09T08:49:14.739Z\",\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"이미지 API (공식)\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/image-api-best-practices\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Grok Imagine 리버스 이미지 생성 및 편집\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"텍스트-이미지 API 레퍼런스\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image#apireference\",\"headline\":\"텍스트-이미지 API 레퍼런스\",\"name\":\"텍스트-이미지 API 레퍼런스\",\"description\":\"Grok Imagine 2 텍스트-이미지 API 레퍼런스 및 실시간 테스트 — prompt만 사용한 생성, 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지\",\"url\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/grok-imagine-image/text-to-image#webpage\"},\"dateModified\":\"2026-11-09T08:49:14.739Z\",\"publisher\":{\"@id\":\"https://docs.apiyi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"API易文档中心\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"API易文档中心\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/api-capabilities/grok-imagine-image/text-to-image.md","siteName":"API易文档中心","nav":{"global":{"anchors":[]},"languages":[{"language":"zh","pages":[{"title":"zh","href":"/api-capabilities/grok-imagine-image/text-to-image"}]},{"language":"en","navbar":{"links":[{"href":"https://api.apiyi.com","label":"Home"},{"href":"https://imagen.apiyi.com","label":"AI Image"},{"href":"https://icover.ai","label":"AI Video"}],"primary":{"type":"button","label":"Console","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"en","href":"/en/api-capabilities/grok-imagine-image/text-to-image"}]},{"language":"zh-Hant","banner":{"content":"本頁由程式自動轉換為繁體中文,用詞以台灣正體為準;如有歧義請以[簡體中文版](/)為準。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 整合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 開發者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"使用者口碑 / Wall of Love","items":[{"label":"使用者口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首頁"},{"href":"https://imagen.apiyi.com","label":"AI出圖"},{"href":"https://icover.ai","label":"AI影片"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"zh-Hant","href":"/zh-Hant/api-capabilities/grok-imagine-image/text-to-image"}]},{"language":"ja","banner":{"content":"このページは AI により翻訳されています。内容に相違がある場合は[English 版](/en)を正としてください。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI統合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI開発者キット(中国語)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"ユーザーの声 / Wall of Love","items":[{"label":"ユーザーの声(中国語)","href":"/wall-of-love"},{"label":"Wall of Love(英語)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"ホーム"},{"href":"https://imagen.apiyi.com","label":"AI画像生成"},{"href":"https://icover.ai","label":"AI動画生成"}],"primary":{"type":"button","label":"コンソール","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"ja","href":"/ja/api-capabilities/grok-imagine-image/text-to-image"}]},{"language":"ko","banner":{"content":"이 페이지는 AI로 번역되었습니다. 내용이 다를 경우 [English 버전](/en)을 기준으로 하십시오.","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 통합","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 개발자 키트(중국어)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"사용자 후기 / Wall of Love","items":[{"label":"사용자 후기(중국어)","href":"/wall-of-love"},{"label":"Wall of Love (영문)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"홈"},{"href":"https://imagen.apiyi.com","label":"AI 이미지 생성"},{"href":"https://icover.ai","label":"AI 동영상 생성"}],"primary":{"type":"button","label":"콘솔","href":"https://api.apiyi.com/account/profile"}},"tabs":[{"tab":"홈","icon":"house","groups":[{"group":"기초","pages":[{"title":"APIYI - AI 모델 API 허브","sidebarTitle":"소개","icon":"house","href":"/ko"},{"title":"빠른 시작","icon":"rocket","href":"/ko/getting-started"},{"group":"AI 개발자 키트","icon":"terminal","pages":[{"title":"AI 개발 키트","sidebarTitle":"AI 개발 키트","icon":"bot","href":"/ko/developer-kit"},{"title":"터미널에 apiyi 명령을 찾을 수 없다고 표시되는 이유","icon":"terminal","href":"/ko/faq/apiyi-cli-command-not-found"}]},{"group":"API 매뉴얼","icon":"book","pages":[{"title":"API 매뉴얼","sidebarTitle":"매뉴얼 개요","icon":"book","href":"/ko/api-manual"},{"title":"API 오류 세부 정보 캡처","sidebarTitle":"오류 캡처","icon":"clipboard-list","href":"/ko/api-manual/error-reporting"},{"group":"API 연동 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"APIYI는 파일 API를 지원하나요?","icon":"file-up","href":"/ko/faq/files-api-not-supported"},{"title":"기본 URL을 구성하는 방법은 무엇입니까? /v1, 루트 도메인 및 /v1beta의 차이","icon":"link","href":"/ko/faq/base-url-config"},{"title":"모델 API 오류는 어떻게 해결하나요?","icon":"alert-triangle","href":"/ko/faq/model-error-troubleshooting"},{"title":"API 동시 실행 수 제한은 무엇입니까?","icon":"gauge","href":"/ko/faq/api-concurrency"}]}]},{"title":"가격 책정","icon":"badge-dollar-sign","href":"/ko/pricing"}]},{"group":"기본 API","icon":"box","pages":[{"group":"인기 모델","icon":"cpu","root":{"title":"인기 모델 추천 - APIYI, 항상 최신 정보","sidebarTitle":"인기 모델","icon":"database","href":"/ko/api-capabilities/model-info"},"pages":[{"group":"모델 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"적합한 AI 모델을 선택하는 방법은 무엇입니까?","icon":"compass","href":"/ko/faq/model-selection-guide"},{"title":"공식 웹 앱과 API는 왜 서로 다른 결과를 제공합니까?","icon":"layers","href":"/ko/faq/webapp-vs-api-difference"},{"title":"AI 모델은 왜 자신의 버전을 알지 못하나요?","icon":"circle-question-mark","href":"/ko/faq/model-version-identity"}]}]},{"title":"이미지 및 동영상 생성 모델","icon":"palette","href":"/ko/api-capabilities/image-video-models"},{"group":"OpenAI API 호출","icon":"sparkles","pages":[{"title":"OpenAI Responses API 네이티브 가이드","sidebarTitle":"네이티브 호출","icon":"zap","href":"/ko/api-capabilities/openai/native"},{"title":"OpenAI 채팅 완성 호환 모드","sidebarTitle":"호환 모드","icon":"plug","href":"/ko/api-capabilities/openai/compatible"},{"title":"엔드포인트 선택: GPT-5.4+를 Responses로 마이그레이션하기","sidebarTitle":"엔드포인트 및 마이그레이션","icon":"route","href":"/ko/api-capabilities/openai/responses-migration"},{"title":"OpenAI 호환 모드: 응답 처리","sidebarTitle":"응답 처리","icon":"braces","href":"/ko/api-capabilities/openai/response-handling"},{"title":"OpenAI 호환 모드: 추론 모델 출력","sidebarTitle":"추론 모델 출력","icon":"brain","href":"/ko/api-capabilities/openai/reasoning-models"},{"title":"OpenAI 프롬프트 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/openai/prompt-caching"},{"title":"OpenAI 함수 호출 가이드","sidebarTitle":"함수 호출","icon":"wrench","href":"/ko/api-capabilities/openai/function-calling"},{"title":"OpenAI API 웹 검색 가이드","sidebarTitle":"웹 검색","icon":"globe","href":"/ko/api-capabilities/openai/web-search"},{"group":"OpenAI 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"APIYI는 OpenAI 빠른 모드/초고속 모드를 지원합니까?","icon":"gauge","href":"/ko/faq/openai-service-tier-fast-mode"},{"title":"콘텐츠가 필터링될 때 스트리밍 요청과 비스트리밍 요청은 어떻게 다릅니까?","sidebarTitle":"스트리밍 및 콘텐츠 필터링","icon":"shield-half","href":"/ko/faq/streaming-content-filter"},{"title":"OpenAI 모델의 요청 거부는 어떤 형태로 나타납니까?","icon":"message-square-x","href":"/ko/faq/openai-content-safety-refusal"}]}]},{"group":"Claude 공식","icon":"sparkles","pages":[{"title":"Claude API 호출 기초","sidebarTitle":"Claude API 기초","icon":"sparkles","href":"/ko/api-capabilities/claude"},{"title":"Claude 네이티브 형식: 스트리밍 및 비스트리밍 응답","sidebarTitle":"스트리밍 및 응답","icon":"braces","href":"/ko/api-capabilities/claude-response-handling"},{"title":"Claude 프롬프트 캐싱 가이드","sidebarTitle":"프롬프트 캐싱","icon":"database","href":"/ko/api-capabilities/claude-prompt-caching"},{"title":"Claude 노력 및 사고 가이드","sidebarTitle":"Claude 사고 가이드","icon":"gauge","href":"/ko/api-capabilities/claude-effort-thinking"},{"title":"Claude API 웹 검색 가이드","sidebarTitle":"Claude 웹 검색","icon":"globe","href":"/ko/api-capabilities/claude-web-search"},{"group":"Claude 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Claude가 Qwen 또는 DeepSeek이라고 주장하는 이유는 무엇입니까?","icon":"venetian-mask","href":"/ko/faq/claude-identity-confusion"},{"title":"Claude의 잘못된 추론 서명 오류를 어떻게 해결합니까?","icon":"file-signature","href":"/ko/faq/claude-thinking-signature-invalid"},{"title":"Claude의 거부 응답에 콘텐츠가 비어 있는 이유는 무엇입니까?","icon":"message-square-x","href":"/ko/faq/claude-content-safety-refusal"}]}]},{"group":"Gemini 네이티브 호출","icon":"sparkles","pages":[{"title":"Gemini 네이티브 형식 가이드","sidebarTitle":"네이티브 호출","icon":"zap","href":"/ko/api-capabilities/gemini/native"},{"title":"Interactions API와 generateContent 비교","sidebarTitle":"Interactions API 비교","icon":"git-compare","href":"/ko/api-capabilities/gemini/interactions-api"},{"title":"Gemini 네이티브 형식: 스트리밍 및 비스트리밍 응답","sidebarTitle":"스트리밍 및 응답","icon":"braces","href":"/ko/api-capabilities/gemini/response-handling"},{"title":"Gemini 멀티모달 입력 및 코드 실행","sidebarTitle":"멀티모달 및 코드 실행","icon":"images","href":"/ko/api-capabilities/gemini/multimodal"},{"title":"Gemini 암시적 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/gemini/prompt-caching"},{"title":"Gemini 함수 호출 가이드","sidebarTitle":"함수 호출","icon":"wrench","href":"/ko/api-capabilities/gemini/function-calling"},{"title":"Gemini API 웹 검색 안내서","sidebarTitle":"웹 검색","icon":"globe","href":"/ko/api-capabilities/gemini/web-search"},{"title":"도구 호출에서 Gemini thought_signature 400 오류를 어떻게 해결합니까?","icon":"file-signature","href":"/ko/faq/gemini-thought-signature-missing"}]},{"group":"Grok API 호출","icon":"sparkles","pages":[{"title":"Grok 모델 시리즈 가이드","sidebarTitle":"Grok 개요","icon":"rocket","href":"/ko/api-capabilities/grok/overview"},{"title":"Grok 채팅 및 추론 가이드","sidebarTitle":"채팅 및 추론","icon":"message-square","href":"/ko/api-capabilities/grok/chat"},{"title":"Grok 웹 검색 및 X 검색 가이드","sidebarTitle":"웹 및 X 검색","icon":"globe","href":"/ko/api-capabilities/grok/web-search"},{"title":"Grok 코드 실행 및 원격 MCP 가이드","sidebarTitle":"코드 실행 및 MCP","icon":"terminal","href":"/ko/api-capabilities/grok/code-execution-mcp"},{"title":"Grok 멀티 에이전트 모델 가이드","sidebarTitle":"멀티 에이전트 모델","icon":"users","href":"/ko/api-capabilities/grok/multi-agent"},{"title":"Grok 프롬프트 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/grok/prompt-caching"}]},{"group":"텍스트 API 모범 사례","icon":"book-check","pages":[{"title":"장문 출력 실무","sidebarTitle":"장문 출력","icon":"book-check","href":"/ko/api-capabilities/long-form-output-practices"},{"title":"멀티턴 대화 가이드","sidebarTitle":"멀티턴 대화","icon":"messages-square","href":"/ko/api-capabilities/multi-turn-conversation"},{"group":"텍스트 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"추론 모델이 빈 콘텐츠를 반환하는 이유는 무엇입니까?","icon":"alert-circle","href":"/ko/faq/reasoning-model-empty-response"},{"title":"스트리밍 호출과 비스트리밍 호출의 차이는 무엇입니까?","sidebarTitle":"스트리밍과 비스트리밍","icon":"audio-lines","href":"/ko/faq/streaming-vs-non-streaming"},{"title":"max_tokens란 무엇입니까? 설정하지 않으면 어떻게 됩니까?","icon":"sliders-horizontal","href":"/ko/faq/max-tokens"},{"title":"API에 ChatGPT와 같은 메모리가 있습니까?","icon":"brain","href":"/ko/faq/api-memory"}]}]},{"title":"잔액 조회 API","icon":"wallet","href":"/ko/api-capabilities/balance-query"},{"title":"로그 조회 API","icon":"file-text","href":"/ko/api-capabilities/log-query"},{"title":"토큰 관리 API","icon":"key","href":"/ko/api-capabilities/token-management"},{"title":"사용 중단 예정 모델","icon":"triangle-alert","href":"/ko/api-capabilities/deprecated-models"}]},{"group":"이미지 API (공식)","icon":"image","pages":[{"group":"이미지 API 핵심","icon":"book-check","pages":[{"title":"이미지 API 필수 사항 및 모범 사례","sidebarTitle":"필독 사항 및 모범 사례","icon":"book-check","href":"/ko/api-capabilities/image-api-best-practices"},{"title":"이미지 API 연결 끊김 문제 해결","sidebarTitle":"연결 끊김","icon":"unplug","href":"/ko/api-capabilities/image-connection-drops"},{"title":"데이터가 도착한 후 멈추는 이미지 요청","sidebarTitle":"마지막 단계에서 멈추는 요청","icon":"hourglass","href":"/ko/api-capabilities/image-tail-stall"},{"title":"이미지 압축 및 출력 해상도","sidebarTitle":"압축 및 해상도","icon":"scaling","href":"/ko/api-capabilities/image-compression-resolution"},{"title":"만족스러운 이미지를 얻는 방법","sidebarTitle":"만족스러운 이미지 얻기","icon":"target","href":"/ko/api-capabilities/image-generation-success-tips"},{"title":"안전성 거부 문제 해결: 제거 실험으로 트리거 단어 찾기","sidebarTitle":"안전성 거부","icon":"shield-alert","href":"/ko/api-capabilities/image-safety-troubleshooting"},{"title":"긴 프롬프트와 2단계 생성: 32K 제한은 어디에서 비롯되는가","sidebarTitle":"긴 프롬프트","icon":"text-quote","href":"/ko/api-capabilities/image-long-prompt"},{"title":"고급 이미지 생성: 워크플로 및 사실감","sidebarTitle":"고급 워크플로","icon":"workflow","href":"/ko/api-capabilities/image-advanced-workflow"},{"title":"이미지 prompt 닥터 스킬","sidebarTitle":"prompt 닥터 스킬","icon":"stethoscope","href":"/ko/api-capabilities/image-prompt-doctor"},{"group":"이미지 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"이미지가 생성된 후 거부될 수 있습니까?","sidebarTitle":"출력 이미지 검토","icon":"shield-alert","href":"/ko/faq/image-output-safety-review"},{"title":"텍스트와 생성 이미지를 모두 출력하는 대화형 API가 있습니까?","sidebarTitle":"하나의 API로 텍스트 + 이미지","icon":"images","href":"/ko/faq/text-and-image-in-one-api"},{"title":"이미지 요청이 결과 없이 멈추지만 로그에는 쓰기 실패가 표시됩니까?","icon":"hourglass","href":"/ko/faq/image-direct-large-response-stall"},{"title":"프록시 뒤에서 약 90초 후 이미지 호출이 끊기나요?","icon":"unplug","href":"/ko/faq/proxy-idle-timeout-disconnect"},{"title":"생성된 이미지가 참조 이미지와 크게 다른 이유는 무엇인가요?","icon":"image","href":"/ko/faq/image-result-differs-from-reference"},{"title":"이미지 콘텐츠가 MIME 유형과 일치하지 않음 오류를 해결하는 방법은 무엇인가요?","icon":"image","href":"/ko/faq/image-mime-type-mismatch-with-query"},{"title":"비동기 이미지 API가 있습니까? 작업 ID로 결과를 조회할 수 있습니까?","icon":"image","href":"/ko/faq/image-async-api"}]}]},{"group":"GPT-Image-2.6 / 2.5 / 2 이미지 생성","icon":"sparkles","pages":[{"title":"GPT-Image-2.6 / 2.5 / 2 이미지 생성/편집","sidebarTitle":"GPT-Image-2.6 / 2.5 / 2 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-image-2/overview"},{"title":"GPT Image 2.6 새로운 기능","sidebarTitle":"GPT Image 2.6 기능","openapi":"api-reference/gpt-image-2-6-generate-openapi-en.yaml POST /v1/images/generations","icon":"sparkles","href":"/ko/api-capabilities/gpt-image-2/gpt-image-2-6"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2/image-edit"},{"title":"GPT-Image-2.5 / 2 시리즈 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2/skills"},{"title":"마스크 인페인팅 가이드","sidebarTitle":"마스크 인페인팅","icon":"brush","href":"/ko/api-capabilities/gpt-image-2/mask-editing"},{"title":"GPT-이미지 레거시 버전","sidebarTitle":"GPT-이미지 레거시","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/gpt-image-2/historical-versions"},{"group":"GPT-Image 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"SVG 생성에 사용할 수 있는 reasoning effort 값은 무엇입니까?","icon":"sliders-horizontal","href":"/ko/faq/gpt-image-svg-reasoning-effort"},{"title":"투명한 배경의 이미지(PNG 누끼)는 어떻게 생성합니까?","icon":"layers","href":"/ko/faq/image-transparent-background"},{"title":"GPT Image 출력 token이 왜 이렇게 높은가요?","icon":"calculator","href":"/ko/faq/gpt-image-output-token-calculation"},{"title":"잘못된 API 키로 인해 GPT-Image용 Codex 통합 실패","sidebarTitle":"OpenAI에서 이미지 키 거부","icon":"key-round","href":"/ko/faq/gpt-image-incorrect-api-key-openai"}]}]},{"title":"GPT-image-2.5 / 2 공식 모델과 리버스 모델 비교","sidebarTitle":"GPT-image-2.5 / 2 공식 모델과 리버스 모델 비교","icon":"scale","href":"/ko/api-capabilities/gpt-image-2/vs-gpt-image-2-all"},{"group":"GPT-Image-2.5-All 이미지 생성","icon":"sparkles","pages":[{"title":"GPT-Image-2.5-All 이미지 생성/편집","sidebarTitle":"GPT-Image-2.5-All 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-image-2-all/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-all-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2-all/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-all-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2-all/image-edit"},{"title":"GPT-Image-2.5-All 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2-all/skills"}]},{"group":"GPT-Image-2.5-VIP 이미지 생성","icon":"expand","pages":[{"title":"GPT-Image-2.5-VIP 이미지 생성/편집","sidebarTitle":"GPT-Image-2.5-VIP 개요","icon":"expand","href":"/ko/api-capabilities/gpt-image-2-vip/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-vip-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2-vip/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-vip-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2-vip/image-edit"},{"title":"GPT-Image-2.5-VIP 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2-vip/skills"}]},{"title":"Nano Banana 시리즈 요금","icon":"tag","href":"/ko/api-capabilities/nano-banana-pricing"},{"group":"NanoBanana 모범 사례","icon":"lightbulb","pages":[{"title":"Nano Banana 시리즈 개발자 가이드","icon":"compass","href":"/ko/api-capabilities/nano-banana-dev-guide"},{"title":"사용량 필드 및 출력 설명","sidebarTitle":"사용량 필드 및 출력 설명","icon":"receipt-text","href":"/ko/api-capabilities/nano-banana-usage-metadata"},{"title":"Gemini 이미지 생성 API 오류 처리 가이드","icon":"triangle-alert","href":"/ko/api-capabilities/gemini-image-error-handling"},{"title":"다중 이미지 융합 테스트 가이드","sidebarTitle":"다중 이미지 융합 테스트","icon":"layers","href":"/ko/api-capabilities/multi-image-fusion-testing"},{"title":"Nano Banana Pro 생성 실패 크레딧 환급 플랜","icon":"shield-check","href":"/ko/api-capabilities/nano-banana-pro-guarantee"},{"title":"Nano Banana OSS 그룹","icon":"link","href":"/ko/api-capabilities/nano-banana-oss-group"},{"group":"NB 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Google 모델은 AI Studio에서 실행됩니까, 아니면 Vertex에서 실행됩니까?","icon":"split","href":"/ko/faq/google-upstream-aistudio-vertex"},{"title":"이미지 편집에서 입력 이미지를 처리할 수 없다고 반환됩니까?","icon":"image-off","href":"/ko/faq/gemini-empty-inlinedata"},{"title":"Gemini 이미지가 IMAGE_OTHER를 반환하는 이유는 무엇입니까?","sidebarTitle":"IMAGE_OTHER","icon":"image-minus","href":"/ko/faq/gemini-image-other"},{"title":"Gemini 이미지에서 blockReason: OTHER가 반환되는 이유는 무엇인가요?","sidebarTitle":"blockReason: OTHER","icon":"shield-alert","href":"/ko/faq/gemini-image-input-blocked"},{"title":"Nano Banana 이미지 생성 실패의 일반적인 원인","icon":"image-off","href":"/ko/faq/nano-banana-image-failure"},{"title":"Gemini 이미지 API가 NO_IMAGE를 반환하는 이유는 무엇인가요?","icon":"image-off","href":"/ko/faq/gemini-no-image"},{"title":"Nano Banana Pro로 편집한 후 이미지가 붉게 변하는 이유는 무엇인가요?","icon":"image","href":"/ko/faq/banana-pro-edit-red-cast"},{"title":"Nano Banana Pro로 의상을 변경할 때 왜곡된 결과물을 수정하는 방법은 무엇입니까?","icon":"shirt","href":"/ko/faq/nano-banana-pro-print-distortion"},{"title":"흰색 배경 이미지에 검은 점, 얼룩 또는 흐릿한 색상 블록이 나타나는 이유는 무엇입니까?","icon":"triangle-alert","href":"/ko/faq/white-background-image-artifacts"}]}]},{"group":"Nano Banana 2.1 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana 2.1 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/gemini-nano-banana-2.1/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gemini-nano-banana-2.1-generate-openapi-en.yaml POST /v1beta/models/gemini-nano-banana-2.1:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/gemini-nano-banana-2.1/text-to-image"},{"title":"이미지 편집 API 참조","openapi":"api-reference/gemini-nano-banana-2.1-edit-openapi-en.yaml POST /v1beta/models/gemini-nano-banana-2.1:generateContent","icon":"image","href":"/ko/api-capabilities/gemini-nano-banana-2.1/image-edit"},{"title":"Nano Banana 2.1 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gemini-nano-banana-2.1/skills"}]},{"group":"Nano Banana Pro 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana Pro 이미지 생성","icon":"banana","href":"/ko/api-capabilities/nano-banana-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-pro-generate-openapi-en.yaml POST /v1beta/models/gemini-3-pro-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/nano-banana-pro-edit-openapi-en.yaml POST /v1beta/models/gemini-3-pro-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-image/image-edit"},{"title":"Nano Banana Pro 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/nano-banana-image/skills"}]},{"group":"Nano Banana 2 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana 2 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/nano-banana-2-image/overview"},{"title":"텍스트-이미지 API 참조","openapi":"api-reference/nano-banana-2-generate-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-2-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/nano-banana-2-edit-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-2-image/image-edit"},{"title":"Nano Banana 2 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/nano-banana-2-image/skills"}]},{"group":"Nano Banana Lite 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana Lite 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/nano-banana-lite-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-lite-generate-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-lite-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/nano-banana-lite-edit-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-lite-image/image-edit"},{"title":"Nano Banana Lite 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/nano-banana-lite-image/skills"}]},{"group":"FLUX 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"FLUX 이미지 생성 및 편집","sidebarTitle":"FLUX 개요","icon":"sparkles","href":"/ko/api-capabilities/flux/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/flux-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/flux/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/flux-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ko/api-capabilities/flux/image-edit"},{"title":"FLUX 이전 버전","sidebarTitle":"이전 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/flux/historical-versions"}]},{"group":"Seedream 5.0 시리즈","icon":"sparkles","pages":[{"title":"Seedream 이미지 생성 및 편집","sidebarTitle":"Seedream 개요","icon":"sparkles","href":"/ko/api-capabilities/seedream-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/seedream-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/seedream-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/seedream-image-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ko/api-capabilities/seedream-image/image-edit"},{"title":"Seedream 이전 버전","sidebarTitle":"이전 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/seedream-image/historical-versions"}]},{"group":"Grok Imagine 공식 이미지 생성","icon":"sparkles","pages":[{"title":"Grok Imagine 공식 이미지 생성","sidebarTitle":"Grok Imagine 공식 개요","icon":"sparkles","href":"/ko/api-capabilities/grok-imagine-image-official/overview"},{"title":"Grok Imagine 공식 텍스트-이미지 API 레퍼런스","sidebarTitle":"텍스트-이미지","openapi":"api-reference/grok-imagine-image-official-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image-official/text-to-image"}]},{"group":"Grok Imagine 리버스 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"Grok Imagine 역방향 이미지 생성 및 편집","sidebarTitle":"Grok Imagine 역방향 개요","description":"APIYI에서 제공하는 Grok Imagine 2 및 xAI의 최신 세대 이미지 모델(grok-imagine-image / grok-imagine-image-quality)에 대한 완벽한 가이드입니다 — 5가지 가로세로 비율, 1K/2K 등급, 호출당 최대 10개 이미지, 진정한 참조 이미지 편집, 해상도와 관계없이 이미지당 고정 $0.02 / $0.045 — 2K에서 정가의 약 64%입니다. 기본적으로 공개되지 않으며, 전용 Grok_imagine_Reverse 그룹을 통해서만 이용할 수 있습니다.","icon":"sparkles","href":"/ko/api-capabilities/grok-imagine-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/grok-imagine-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","description":"Grok Imagine 2 이미지 편집 API 레퍼런스 및 실시간 테스트 — 편집 또는 융합을 위해 참조 이미지 1~4개와 지침을 업로드합니다. multipart/form-data가 필요합니다","openapi":"api-reference/grok-imagine-image-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/grok-imagine-image/image-edit"}]},{"group":"MAI-Image 2.6 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"MAI-Image 2.6 이미지 생성 및 편집","sidebarTitle":"MAI-Image 2.6 개요","icon":"sparkles","href":"/ko/api-capabilities/mai-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/mai-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/mai-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/mai-image-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/mai-image/image-edit"}]},{"title":"이미지 API 통합 실습: 자체 비동기 큐 구축","sidebarTitle":"자체 호스팅 비동기 큐","icon":"list-checks","href":"/ko/api-capabilities/image-async-queue"}]},{"group":"동영상 API (공식)","icon":"video","pages":[{"group":"Seedance 2.0 / 2.5 (Volcengine)","icon":"film","pages":[{"title":"Seedance 2.0 / 2.5 동영상 생성","sidebarTitle":"Seedance 2.0 / 2.5 개요","icon":"film","href":"/ko/api-capabilities/seedance2/overview"},{"title":"Seedance 2.0 / 2.5 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/seedance2-video-openapi-en.yaml POST /seedance/api/v3/contents/generations/tasks","icon":"video","href":"/ko/api-capabilities/seedance2/video-generation"},{"title":"Seedance 2.0 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/seedance2/skills"},{"title":"Seedance 2.0 에셋 라이브러리 (캐릭터 일관성 동영상)","sidebarTitle":"에셋 라이브러리","icon":"images","href":"/ko/api-capabilities/seedance2/asset-library"},{"title":"코드에서 자산을 참조하는 동영상 생성","sidebarTitle":"자산 참조 가이드","icon":"clapperboard","href":"/ko/api-capabilities/seedance2/asset-reference"},{"title":"에셋 우선: 더 빠르고 안정적인 이미지 및 동영상 입력","sidebarTitle":"에셋 우선 워크플로","icon":"gauge","href":"/ko/api-capabilities/seedance2/asset-first-workflow"},{"group":"SD 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Seedance에서 첫/마지막 프레임은 참조 미디어와 혼합할 수 없음","sidebarTitle":"참조 미디어와 혼합된 첫 프레임","icon":"layers","href":"/ko/faq/seedance-first-frame-mixed-with-reference"},{"title":"Seedance에서 이미지 형식이 잘못되었다고 표시되지만 브라우저에서는 링크가 열립니다","sidebarTitle":"이미지 링크는 열리지만 실패함","icon":"link","href":"/ko/faq/seedance-image-url-invalid-format"},{"title":"Seedance 2.5: 참조-투-비디오와 동영상 편집 비교","icon":"split","href":"/ko/faq/seedance2-reference-vs-edit"},{"title":"제출 후 Seedance 동영상 작업을 취소할 수 있습니까?","icon":"video","href":"/ko/faq/seedance-video-task-cancel"},{"title":"task_id로 Seedance 동영상의 실제 비용을 어떻게 조회합니까?","icon":"receipt","href":"/ko/faq/seedance-task-cost-lookup"},{"title":"Seedance 2.0은 얼굴 참조 이미지를 자산 라이브러리에 자동으로 업로드합니까? 딥페이크 필터가 작동합니까?","icon":"banana","href":"/ko/faq/seedance2-asset-face-reference"},{"title":"Seedance 2.0 / 2.5에서 얼굴 에셋이 차단되는 이유는 무엇인가요?","icon":"scan-face","href":"/ko/faq/seedance2-face-asset-whitelist"}]}]},{"group":"Wan3.0 동영상 생성 (Alibaba)","icon":"video","pages":[{"title":"Wan3.0 동영상 생성 (Alibaba Tongyi Wanxiang)","sidebarTitle":"개요","icon":"video","href":"/ko/api-capabilities/wan3/overview"},{"title":"Wan3.0 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/wan3-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/wan3/video-generation"},{"title":"Wan3.0 다운로드 실패: 소스 미디어 URL이 실패하는 이유와 해결 방법","sidebarTitle":"미디어 다운로드 실패","icon":"circle-question-mark","href":"/ko/faq/wan3-media-download-failed"}]},{"group":"Wan2.7 동영상 생성 (Alibaba)","icon":"videotape","pages":[{"title":"Wan 동영상 생성 (알리바바 클라우드 통이 완샹)","sidebarTitle":"Wan 개요","icon":"video","href":"/ko/api-capabilities/wan/overview"},{"title":"Wan2.7 텍스트-동영상 API 레퍼런스","sidebarTitle":"텍스트-동영상","openapi":"api-reference/wan-text-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/wan/text-to-video"},{"title":"Wan2.7 이미지-동영상 API 레퍼런스","sidebarTitle":"이미지-동영상","openapi":"api-reference/wan-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ko/api-capabilities/wan/image-to-video"},{"title":"Wan2.7 레퍼런스-투-비디오 API 레퍼런스","sidebarTitle":"레퍼런스-투-비디오","openapi":"api-reference/wan-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ko/api-capabilities/wan/reference-to-video"},{"title":"Wan2.7 동영상 편집 API 레퍼런스","sidebarTitle":"동영상 편집","openapi":"api-reference/wan-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ko/api-capabilities/wan/video-edit"},{"title":"Wan2.7 및 HappyHorse 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/wan/skills"},{"title":"Wan 이전 버전(Wan2.6)","sidebarTitle":"이전 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/wan/historical-versions"}]},{"group":"HappyHorse 동영상 생성 (Alibaba)","icon":"monitor-play","pages":[{"title":"HappyHorse 동영상 생성(알리바바 클라우드)","sidebarTitle":"HappyHorse 개요","icon":"monitor-play","href":"/ko/api-capabilities/happyhorse/overview"},{"title":"HappyHorse 텍스트-동영상 API 레퍼런스","sidebarTitle":"텍스트-동영상","openapi":"api-reference/happyhorse-text-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/happyhorse/text-to-video"},{"title":"HappyHorse 이미지-동영상 API 레퍼런스","sidebarTitle":"이미지-동영상","openapi":"api-reference/happyhorse-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ko/api-capabilities/happyhorse/image-to-video"},{"title":"HappyHorse 레퍼런스-투-비디오 API 레퍼런스","sidebarTitle":"레퍼런스-투-비디오","openapi":"api-reference/happyhorse-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ko/api-capabilities/happyhorse/reference-to-video"},{"title":"HappyHorse 동영상 편집 API 레퍼런스","sidebarTitle":"동영상 편집","openapi":"api-reference/happyhorse-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ko/api-capabilities/happyhorse/video-edit"},{"title":"HappyHorse 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/happyhorse/skills"}]},{"group":"Grok Imagine 동영상 생성 (xAI)","icon":"camera","pages":[{"title":"Grok Imagine 동영상 생성","sidebarTitle":"Grok Imagine 동영상 개요","icon":"video","href":"/ko/api-capabilities/grok-imagine-video/overview"},{"title":"Grok Imagine 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/grok-imagine-video-openapi-en.yaml POST /v1/videos","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-video/video-generation"}]},{"group":"MiniMax H3 동영상 생성 (자체 호스팅)","icon":"film","pages":[{"title":"MiniMax-H3 동영상 생성","sidebarTitle":"MiniMax-H3 개요","icon":"video","href":"/ko/api-capabilities/minimax-h3/overview"},{"title":"MiniMax-H3 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/minimax-h3-video-openapi-en.yaml POST /hailuo/v2/video_generation","icon":"video","href":"/ko/api-capabilities/minimax-h3/video-generation"}]},{"group":"Oxygen 동영상 생성 (AZ8)","icon":"clapperboard","pages":[{"title":"Oxygen 동영상 생성","sidebarTitle":"Oxygen 개요","icon":"video","href":"/ko/api-capabilities/oxygen/overview"},{"title":"Oxygen 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/oxygen-video-openapi-en.yaml POST /videos","icon":"video","href":"/ko/api-capabilities/oxygen/video-generation"}]}]},{"group":"멀티모달 이해 API","icon":"eye","pages":[{"group":"이미지 이해 API","icon":"eye","root":{"title":"비전 이해(이미지 인식) API","icon":"eye","href":"/ko/api-capabilities/vision-understanding"},"pages":[{"group":"이미지 이해 자주 묻는 질문","icon":"circle-help","expanded":false,"pages":[{"title":"이미지 이해 요청이 계속 시간 초과됩니다 — 이미지가 너무 큰가요?","icon":"image","href":"/ko/faq/vision-image-too-large"}]}]},{"title":"동영상 이해 API","icon":"video","href":"/ko/api-capabilities/video-understanding"}]},{"group":"텍스트 생성","icon":"file-text","pages":[{"title":"텍스트 생성(채팅 완성)","icon":"message-square","href":"/ko/api-capabilities/text-generation"},{"group":"Gemini 4 Argon","icon":"sparkles","pages":[{"title":"Gemini 4 Argon 텍스트 생성","sidebarTitle":"Gemini 4 Argon 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-4-argon/overview"}]},{"group":"GPT-6 Astra","icon":"sparkles","pages":[{"title":"GPT-6 Astra 텍스트 생성","sidebarTitle":"GPT-6 Astra 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-6-astra/overview"}]},{"group":"DeepSeek V4 Flash Vision","icon":"eye","pages":[{"title":"DeepSeek V4 Flash 비전","sidebarTitle":"개요","icon":"eye","href":"/ko/api-capabilities/deepseek-v4-flash-vision/overview"},{"title":"DeepSeek V4 Flash 비전 채팅 API 레퍼런스","sidebarTitle":"채팅 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-vision-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash-vision/chat-completions"},{"title":"DeepSeek V4 Flash Vision 메시지 API 레퍼런스","sidebarTitle":"메시지 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-vision-messages-openapi-en.yaml POST /v1/messages","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash-vision/messages"}]},{"group":"DeepSeek V4 Flash","icon":"zap","pages":[{"title":"DeepSeek V4 Flash 텍스트 생성","sidebarTitle":"개요","icon":"zap","href":"/ko/api-capabilities/deepseek-v4-flash/overview"},{"title":"DeepSeek V4 Flash 채팅 API 레퍼런스","sidebarTitle":"채팅 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash/chat-completions"},{"title":"DeepSeek V4 Flash Responses API 레퍼런스","sidebarTitle":"Responses 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-responses-openapi-en.yaml POST /v1/responses","icon":"git-fork","href":"/ko/api-capabilities/deepseek-v4-flash/responses"}]},{"group":"DeepSeek Search \u0026 Fetch","icon":"search","pages":[{"title":"DeepSeek 웹 검색 및 가져오기 API","sidebarTitle":"개요","icon":"search","href":"/ko/api-capabilities/deepseek-search-fetch/overview"},{"title":"DeepSeek 웹 검색 API 레퍼런스","sidebarTitle":"검색 플레이그라운드","openapi":"api-reference/deepseek-search-openapi-en.yaml POST /v1/tools/search","icon":"terminal","href":"/ko/api-capabilities/deepseek-search-fetch/search-api"},{"title":"DeepSeek 웹 페이지 가져오기 API 레퍼런스","sidebarTitle":"가져오기 플레이그라운드","openapi":"api-reference/deepseek-fetch-openapi-en.yaml POST /v1/tools/fetch","icon":"terminal","href":"/ko/api-capabilities/deepseek-search-fetch/fetch-api"}]},{"group":"Seed 2.1 Turbo","icon":"zap","pages":[{"title":"Seed 2.1 Turbo 텍스트 생성","sidebarTitle":"개요","icon":"message-square","href":"/ko/api-capabilities/dola-seed-2-1-turbo/overview"},{"title":"Seed 2.1 Turbo 채팅 API 레퍼런스","sidebarTitle":"채팅 플레이그라운드","openapi":"api-reference/dola-seed-2-1-turbo-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/dola-seed-2-1-turbo/chat-completions"},{"title":"Seed 2.1 Turbo Responses API 레퍼런스","sidebarTitle":"Responses 플레이그라운드","openapi":"api-reference/dola-seed-2-1-turbo-responses-openapi-en.yaml POST /v1/responses","icon":"messages-square","href":"/ko/api-capabilities/dola-seed-2-1-turbo/responses"}]},{"group":"Gemini Flash 시리즈","icon":"sparkles","pages":[{"title":"Gemini 3.8 Flash 텍스트 생성","sidebarTitle":"Gemini 3.8 Flash 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-3-8-flash/overview"},{"title":"Gemini 3.6 Flash 텍스트 생성","sidebarTitle":"Gemini 3.6 Flash 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-3-6-flash/overview"},{"title":"Gemini 3.6 Flash 네이티브 API 레퍼런스","sidebarTitle":"3.6 네이티브 플레이그라운드","openapi":"api-reference/gemini-3-6-flash-native-openapi-en.yaml POST /v1beta/models/gemini-3.6-flash:generateContent","icon":"terminal","href":"/ko/api-capabilities/gemini-3-6-flash/generate-content"},{"title":"Gemini 3.6 Flash 채팅 API 레퍼런스","sidebarTitle":"3.6 채팅 플레이그라운드","openapi":"api-reference/gemini-3-6-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/gemini-3-6-flash/chat-completions"}]},{"group":"Gemini 3.5 Flash-Lite","icon":"feather","pages":[{"title":"Gemini 3.5 Flash-Lite 텍스트 생성","sidebarTitle":"개요","icon":"feather","href":"/ko/api-capabilities/gemini-3-5-flash-lite/overview"},{"title":"Gemini 3.5 Flash-Lite 네이티브 API 레퍼런스","sidebarTitle":"네이티브 플레이그라운드","openapi":"api-reference/gemini-3-5-flash-lite-native-openapi-en.yaml POST /v1beta/models/gemini-3.5-flash-lite:generateContent","icon":"terminal","href":"/ko/api-capabilities/gemini-3-5-flash-lite/generate-content"},{"title":"Gemini 3.5 Flash-Lite 채팅 API 레퍼런스","sidebarTitle":"채팅 플레이그라운드","openapi":"api-reference/gemini-3-5-flash-lite-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/gemini-3-5-flash-lite/chat-completions"}]},{"group":"Qwen3 시리즈","icon":"puzzle","pages":[{"title":"Qwen3.8-Max 텍스트 생성","sidebarTitle":"개요","icon":"puzzle","href":"/ko/api-capabilities/qwen-3-8/overview"},{"title":"Qwen3.8-Max 채팅 API 레퍼런스","sidebarTitle":"채팅 플레이그라운드","openapi":"api-reference/qwen-3-8-max-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/qwen-3-8/chat-completions"},{"title":"Qwen3.6 텍스트 모델 시리즈 (레거시)","sidebarTitle":"Qwen3.6 (레거시)","icon":"puzzle","href":"/ko/api-capabilities/qwen-3-6/overview"}]},{"group":"Kimi K3.1 Pro","icon":"moon","pages":[{"title":"Kimi K3.1 Pro 개요","sidebarTitle":"개요","icon":"brain","href":"/ko/api-capabilities/kimi-k3-1/overview"}]},{"title":"Kimi K2.5 텍스트 생성","sidebarTitle":"Kimi K2.5","icon":"bot","href":"/ko/api-capabilities/kimi-k2-5"}]},{"group":"음성 API (공식)","icon":"audio-lines","pages":[{"title":"실시간 음성(WebSocket)","sidebarTitle":"실시간 음성 개요","icon":"audio-lines","href":"/ko/api-capabilities/realtime/overview"}]},{"group":"검색 및 안전","icon":"search","pages":[{"title":"텍스트 임베딩 API","icon":"vector-square","href":"/ko/api-capabilities/text-embedding"},{"title":"실제 임베딩 튜닝","sidebarTitle":"임베딩 튜닝","icon":"sliders-horizontal","href":"/ko/api-capabilities/embedding-best-practices"},{"group":"리랭킹","icon":"list-ordered","pages":[{"title":"bge-reranker-v2-m3 텍스트 리랭킹","sidebarTitle":"개요","icon":"list-ordered","href":"/ko/api-capabilities/rerank/overview"},{"title":"재정렬 API 레퍼런스","sidebarTitle":"플레이그라운드","openapi":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml POST /v1/rerank","icon":"terminal","href":"/ko/api-capabilities/rerank/rerank-api"},{"title":"실제 RAG 튜닝","sidebarTitle":"RAG 튜닝","icon":"sliders-horizontal","href":"/ko/api-capabilities/rerank/rag-best-practices"}]},{"title":"텍스트 모더레이션","icon":"shield-check","href":"/ko/api-capabilities/text-moderation"}]}]},{"tab":"활용 사례","icon":"layout-grid","pages":[{"title":"활용 사례","href":"/ko/scenarios"}]},{"tab":"FAQ","icon":"circle-question-mark","pages":[{"title":"FAQ","href":"/ko/faq"}]},{"tab":"실시간 업데이트","icon":"activity","pages":[{"title":"실시간 업데이트","href":"/ko/live"}]},{"tab":"공지사항","icon":"megaphone","pages":[{"title":"공지사항","href":"/ko/changelog"}]},{"tab":"프로모션","icon":"gift","pages":[{"title":"프로모션","href":"/ko/faq/recharge-promotions"}]},{"tab":"모델 요금","icon":"circle-dollar-sign","pages":[{"title":"모델 요금","href":"/ko/models"}]}]},{"language":"ru","banner":{"content":"Эта страница переведена с помощью ИИ. При расхождениях ориентируйтесь на [английскую версию](/en).","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI-интеграция","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"Набор AI-разработчика (кит.)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"Отзывы пользователей / Wall of Love","items":[{"label":"Отзывы пользователей (на китайском)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"Главная"},{"href":"https://imagen.apiyi.com","label":"Генерация изображений"},{"href":"https://icover.ai","label":"Генерация видео"}],"primary":{"type":"button","label":"Консоль","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"ru","href":"/ru/api-capabilities/grok-imagine-image/text-to-image"}]}]},"basePath":"","title":"텍스트-이미지 API 레퍼런스 - API易文档中心","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-6DXXLlfN.js","dist-CmKHfscc.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-C3kuh_dz.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","AssistantPageLink-U3mI6Ljh.js"]}