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 階層、1回の呼び出しで最大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
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":"6af439353717fa42cefcf860","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"zh","tag":"首页","count":213},{"language":"en","tag":"Home","count":213},{"language":"ja","tag":"ホーム","count":213},{"language":"ko","tag":"홈","count":213},{"language":"ru","tag":"Главная","count":213},{"language":"zh-Hant","tag":"首頁","count":213},{"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":81},{"language":"en","tag":"Announcements","count":81},{"language":"zh","tag":"AI风向标","count":78},{"language":"en","tag":"AI Radar","count":78},{"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":"模型价格","count":36},{"language":"en","tag":"Model Pricing","count":36},{"language":"ja","tag":"モデル料金","count":36},{"language":"ko","tag":"모델 요금","count":36},{"language":"ru","tag":"Цены на модели","count":36},{"language":"zh-Hant","tag":"模型價格","count":36},{"language":"zh","tag":"视频 API(官转)","count":35},{"language":"en","tag":"Video API (Official)","count":35},{"language":"ja","tag":"動画API(公式)","count":35},{"language":"ko","tag":"동영상 API (공식)","count":35},{"language":"ru","tag":"Video API (официальный)","count":35},{"language":"zh-Hant","tag":"影片 API(官轉)","count":35},{"language":"zh","tag":"文本生成","count":28},{"language":"en","tag":"Text Generation","count":28},{"language":"ja","tag":"テキスト生成","count":28},{"language":"ko","tag":"텍스트 생성","count":28},{"language":"ru","tag":"Генерация текста","count":28},{"language":"zh-Hant","tag":"文本生成","count":28},{"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":"ja/api-capabilities/grok-imagine-image/text-to-image","slug":"/ja/api-capabilities/grok-imagine-image/text-to-image","pageMetadata":{"title":"テキストから画像への API リファレンス","description":"Grok Imagine 2 のテキストから画像への API リファレンスとライブテスト — prompt のみで生成、5つのアスペクト比、1K/2K 階層、1回の呼び出しで最大10画像","openapi":"api-reference/grok-imagine-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ja/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 階層、1回の呼び出しで最大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`}),` グループには含まれていません。独自の**`,_jsx(_components.code,{children:`Grok_imagine_Reverse`}),`グループ**に属しており、呼び出し(このページのPlaygroundを含む)を行う前にアクセスの申請が必要です。申請がない場合、すべての呼び出しで `,_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:`/ja/api-capabilities/grok-imagine-image/overview#group-setup`,children:`Grok Imagine 2 概要 - グループ設定`}),`。`]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`右側のインタラクティブなPlaygroundを使用すると、エンドポイントを直接テストできます。`,_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:`/ja/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:`/ja/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:[`1つの例外として、`,_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:`/ja/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-生の-requests`,children:`Python (生の requests)`}),`\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:[_jsx(_components.code,{children:`grok-imagine-image`}),` ($0.02/image) または `,_jsx(_components.code,{children:`grok-imagine-image-quality`}),` ($0.045/image)`]})]}),_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:`英語または中国語のプロンプトです。被写体、シーン、スタイル、ライティングを記述してください`})]}),_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:[`1回あたりの画像数、`,_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 を返します(`,_jsx(_components.code,{children:`data:`}),` プレフィックスは`,_jsx(_components.strong,{children:`なし`}),`)`]})]})]})]}),`\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`}),` はサポートされていません(エラーなく受け付けられますが、効果はありません — 結果は再現できません)。マスクによる inpainting もサポートされていません。`,_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.strong,{children:_jsx(_components.code,{children:`url`})}),` または `,_jsx(_components.strong,{children:_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`}),` は照合には使用できません`]}),`: `,_jsx(_components.code,{children:`prompt_tokens`}),` は実際の prompt の長さにかかわらず常に `,_jsx(_components.code,{children:`1000 x n`}),` です。このシリーズは画像ごとの定額料金($0.02 / $0.045)で課金されます。実際の請求額は APIYI Console の課金記録を参照してください。`]})})]})}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 階層、1回の呼び出しで最大10画像","openapi":"api-reference/grok-imagine-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ja/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 (生の requests)","slug":"python-生の-requests","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 階層、1回の呼び出しで最大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":0},"ko":{"href":"/ko/api-capabilities/grok-imagine-image/text-to-image","matchLevel":1},"ru":{"href":"/ru/api-capabilities/grok-imagine-image/text-to-image","matchLevel":1}}},"lastModified":"2026-10-20T16:50:02.188Z","originalFileLocation":"ja/api-capabilities/grok-imagine-image/text-to-image.mdx","locale":"ja"},"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 階層、1回の呼び出しで最大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 階層、1回の呼び出しで最大10画像\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API易文档中心\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apiyi.com/ja/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+%E3%83%AA%E3%83%90%E3%83%BC%E3%82%B9%E7%94%BB%E5%83%8F%E7%94%9F%E6%88%90%E3%83%BB%E7%B7%A8%E9%9B%86\u0026amp;title=%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%8B%E3%82%89%E7%94%BB%E5%83%8F%E3%81%B8%E3%81%AE+API+%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9\u0026amp;description=Grok+Imagine+2+%E3%81%AE%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%8B%E3%82%89%E7%94%BB%E5%83%8F%E3%81%B8%E3%81%AE+API+%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9%E3%81%A8%E3%83%A9%E3%82%A4%E3%83%96%E3%83%86%E3%82%B9%E3%83%88+%E2%80%94+prompt+%E3%81%AE%E3%81%BF%E3%81%A7%E7%94%9F%E6%88%90%E3%80%815%E3%81%A4%E3%81%AE%E3%82%A2%E3%82%B9%E3%83%9A%E3%82%AF%E3%83%88%E6%AF%94%E3%80%811K%2F2K+%E9%9A%8E%E5%B1%A4%E3%80%811%E5%9B%9E%E3%81%AE%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E3%81%A7%E6%9C%80%E5%A4%A710%E7%94%BB%E5%83%8F\u0026amp;theme=84509e4a5d1cb12fd162de92\u0026amp;signature=fa4e3f477ba7d7bc5ebbb373fa38c1ee2b7c5290430f13850e97477ae2349ad7\">\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 階層、1回の呼び出しで最大10画像\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apiyillc.mintlify.site/_mintlify/api/og/v2?division=Grok+Imagine+%E3%83%AA%E3%83%90%E3%83%BC%E3%82%B9%E7%94%BB%E5%83%8F%E7%94%9F%E6%88%90%E3%83%BB%E7%B7%A8%E9%9B%86\u0026amp;title=%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%8B%E3%82%89%E7%94%BB%E5%83%8F%E3%81%B8%E3%81%AE+API+%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9\u0026amp;description=Grok+Imagine+2+%E3%81%AE%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%8B%E3%82%89%E7%94%BB%E5%83%8F%E3%81%B8%E3%81%AE+API+%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9%E3%81%A8%E3%83%A9%E3%82%A4%E3%83%96%E3%83%86%E3%82%B9%E3%83%88+%E2%80%94+prompt+%E3%81%AE%E3%81%BF%E3%81%A7%E7%94%9F%E6%88%90%E3%80%815%E3%81%A4%E3%81%AE%E3%82%A2%E3%82%B9%E3%83%9A%E3%82%AF%E3%83%88%E6%AF%94%E3%80%811K%2F2K+%E9%9A%8E%E5%B1%A4%E3%80%811%E5%9B%9E%E3%81%AE%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E3%81%A7%E6%9C%80%E5%A4%A710%E7%94%BB%E5%83%8F\u0026amp;theme=84509e4a5d1cb12fd162de92\u0026amp;signature=fa4e3f477ba7d7bc5ebbb373fa38c1ee2b7c5290430f13850e97477ae2349ad7\">\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/ja/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=\"/ja/api-capabilities/grok-imagine-image/text-to-image.md\">\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=\"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=\"ko\" href=\"https://docs.apiyi.com/ko/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/ja/api-capabilities/grok-imagine-image/text-to-image#webpage\",\"url\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image\",\"name\":\"テキストから画像への API リファレンス\",\"description\":\"Grok Imagine 2 のテキストから画像への API リファレンスとライブテスト — prompt のみで生成、5つのアスペクト比、1K/2K 階層、1回の呼び出しで最大10画像\",\"dateModified\":\"2026-10-20T16:50:02.188Z\",\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"画像API(公式)\",\"item\":\"https://docs.apiyi.com/ja/api-capabilities/image-api-best-practices\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Grok Imagine リバース画像生成・編集\",\"item\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"テキストから画像への API リファレンス\",\"item\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image#apireference\",\"headline\":\"テキストから画像への API リファレンス\",\"name\":\"テキストから画像への API リファレンス\",\"description\":\"Grok Imagine 2 のテキストから画像への API リファレンスとライブテスト — prompt のみで生成、5つのアスペクト比、1K/2K 階層、1回の呼び出しで最大10画像\",\"url\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apiyi.com/ja/api-capabilities/grok-imagine-image/text-to-image#webpage\"},\"dateModified\":\"2026-10-20T16:50:02.188Z\",\"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":"/ja/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"}},"tabs":[{"tab":"ホーム","icon":"house","groups":[{"group":"基本","pages":[{"title":"APIYI - AIモデルAPIハブ","sidebarTitle":"はじめに","icon":"house","href":"/ja"},{"title":"クイックスタート","icon":"rocket","href":"/ja/getting-started"},{"group":"AI開発者キット","icon":"terminal","pages":[{"title":"AI開発キット","sidebarTitle":"AI開発キット","icon":"bot","href":"/ja/developer-kit"},{"title":"ターミナルで apiyi コマンドが見つからないと表示されるのはなぜですか?","icon":"terminal","href":"/ja/faq/apiyi-cli-command-not-found"}]},{"group":"APIマニュアル","icon":"book","pages":[{"title":"API マニュアル","sidebarTitle":"マニュアル概要","icon":"book","href":"/ja/api-manual"},{"title":"API エラー詳細の取得","sidebarTitle":"エラー取得","icon":"clipboard-list","href":"/ja/api-manual/error-reporting"},{"group":"API接続 よくある質問","icon":"circle-question-mark","expanded":false,"pages":[{"title":"APIYIはFiles APIに対応していますか?","icon":"file-up","href":"/ja/faq/files-api-not-supported"},{"title":"Base URLの設定方法は? /v1、ルートドメイン、/v1beta の違い","icon":"link","href":"/ja/faq/base-url-config"},{"title":"モデル API エラーをトラブルシューティングするには?","icon":"alert-triangle","href":"/ja/faq/model-error-troubleshooting"},{"title":"APIの同時実行数制限とは?","icon":"gauge","href":"/ja/faq/api-concurrency"}]}]},{"title":"料金","icon":"badge-dollar-sign","href":"/ja/pricing"}]},{"group":"基本API","icon":"box","pages":[{"group":"人気モデル","icon":"cpu","root":{"title":"人気モデルのおすすめ - APIYI、常に最新","sidebarTitle":"人気モデル","icon":"database","href":"/ja/api-capabilities/model-info"},"pages":[{"group":"モデル よくある質問","icon":"circle-question-mark","expanded":false,"pages":[{"title":"適切なAIモデルの選び方","icon":"compass","href":"/ja/faq/model-selection-guide"},{"title":"公式WebアプリとAPIで結果が異なるのはなぜですか?","icon":"layers","href":"/ja/faq/webapp-vs-api-difference"},{"title":"なぜ AI モデルは自分自身のバージョンを把握できないのか?","icon":"circle-question-mark","href":"/ja/faq/model-version-identity"}]}]},{"title":"画像・動画生成モデル","icon":"palette","href":"/ja/api-capabilities/image-video-models"},{"group":"OpenAI API呼び出し","icon":"sparkles","pages":[{"title":"OpenAI Responses API ネイティブガイド","sidebarTitle":"ネイティブ呼び出し","icon":"zap","href":"/ja/api-capabilities/openai/native"},{"title":"OpenAI Chat Completions 互換モード","sidebarTitle":"互換モード","icon":"plug","href":"/ja/api-capabilities/openai/compatible"},{"title":"エンドポイントの選択:GPT-5.4以降をResponsesへ移行","sidebarTitle":"エンドポイントと移行","icon":"route","href":"/ja/api-capabilities/openai/responses-migration"},{"title":"OpenAI Compatible モード: レスポンスの処理","sidebarTitle":"レスポンスの処理","icon":"braces","href":"/ja/api-capabilities/openai/response-handling"},{"title":"OpenAI Compatible Mode: Reasoning Model Output","sidebarTitle":"Reasoning Model Output","icon":"brain","href":"/ja/api-capabilities/openai/reasoning-models"},{"title":"OpenAI プロンプトキャッシュ課金ガイド","sidebarTitle":"キャッシュ課金","icon":"database","href":"/ja/api-capabilities/openai/prompt-caching"},{"title":"OpenAI Function Calling ガイド","sidebarTitle":"ファンクション・コーリング","icon":"wrench","href":"/ja/api-capabilities/openai/function-calling"},{"title":"OpenAI API Web Search ガイド","sidebarTitle":"Web検索","icon":"globe","href":"/ja/api-capabilities/openai/web-search"},{"group":"OpenAI よくある質問","icon":"circle-question-mark","pages":[{"title":"APIYIはOpenAIのFast / Ultrafastモードに対応していますか?","icon":"gauge","href":"/ja/faq/openai-service-tier-fast-mode"},{"title":"コンテンツがフィルタリングされた際、ストリーミングと非ストリーミングリクエストはどう異なりますか?","sidebarTitle":"ストリーミングとコンテンツフィルタリング","icon":"shield-half","href":"/ja/faq/streaming-content-filter"},{"title":"OpenAI モデルの拒否応答はどのようなものですか?","icon":"message-square-x","href":"/ja/faq/openai-content-safety-refusal"}]}]},{"group":"Claude 公式","icon":"sparkles","pages":[{"title":"Claude API 呼び出しの基本","sidebarTitle":"Claude API の基本","icon":"sparkles","href":"/ja/api-capabilities/claude"},{"title":"Claude ネイティブ形式: ストリーミングと非ストリーミングのレスポンス","sidebarTitle":"ストリーミングとレスポンス","icon":"braces","href":"/ja/api-capabilities/claude-response-handling"},{"title":"Claude Prompt Caching ガイド","sidebarTitle":"Prompt Caching","icon":"database","href":"/ja/api-capabilities/claude-prompt-caching"},{"title":"Claude の effort と thinking ガイド","sidebarTitle":"Claude の thinking ガイド","icon":"gauge","href":"/ja/api-capabilities/claude-effort-thinking"},{"title":"Claude API Web検索ガイド","sidebarTitle":"Claude Web検索","icon":"globe","href":"/ja/api-capabilities/claude-web-search"},{"group":"Claude よくある質問","icon":"circle-question-mark","pages":[{"title":"Claude はなぜ Qwen や DeepSeek を名乗るのか?","icon":"venetian-mask","href":"/ja/faq/claude-identity-confusion"},{"title":"ClaudeのInvalid Thinking Signatureエラーを修正するにはどうすればよいですか?","icon":"file-signature","href":"/ja/faq/claude-thinking-signature-invalid"},{"title":"なぜClaudeの拒否応答は空のコンテンツを返すのですか?","icon":"message-square-x","href":"/ja/faq/claude-content-safety-refusal"}]}]},{"group":"Gemini ネイティブ呼び出し","icon":"sparkles","pages":[{"title":"Gemini ネイティブ形式ガイド","sidebarTitle":"ネイティブ呼び出し","icon":"zap","href":"/ja/api-capabilities/gemini/native"},{"title":"Interactions API 対 generateContent","sidebarTitle":"Interactions API の比較","icon":"git-compare","href":"/ja/api-capabilities/gemini/interactions-api"},{"title":"Gemini ネイティブ形式: ストリーミングと非ストリーミング応答","sidebarTitle":"ストリーミングと応答","icon":"braces","href":"/ja/api-capabilities/gemini/response-handling"},{"title":"Gemini マルチモーダル入力とコード実行","sidebarTitle":"マルチモーダルとコード実行","icon":"images","href":"/ja/api-capabilities/gemini/multimodal"},{"title":"Gemini 暗黙的キャッシュ 課金ガイド","sidebarTitle":"キャッシュ課金","icon":"database","href":"/ja/api-capabilities/gemini/prompt-caching"},{"title":"Gemini 関数呼び出しガイド","sidebarTitle":"関数呼び出し","icon":"wrench","href":"/ja/api-capabilities/gemini/function-calling"},{"title":"Gemini API Web Search ガイド","sidebarTitle":"Web Search","icon":"globe","href":"/ja/api-capabilities/gemini/web-search"},{"title":"ツール呼び出しにおける Gemini Thought Signature 400 エラーを解決する方法","icon":"file-signature","href":"/ja/faq/gemini-thought-signature-missing"}]},{"group":"Grok API呼び出し","icon":"sparkles","pages":[{"title":"Grok モデルシリーズガイド","sidebarTitle":"Grok 概要","icon":"rocket","href":"/ja/api-capabilities/grok/overview"},{"title":"Grok Chat \u0026 推論ガイド","sidebarTitle":"チャットと推論","icon":"message-square","href":"/ja/api-capabilities/grok/chat"},{"title":"Grok Web Search \u0026 X Search ガイド","sidebarTitle":"Web \u0026 X Search","icon":"globe","href":"/ja/api-capabilities/grok/web-search"},{"title":"Grok Code Execution \u0026 Remote MCP ガイド","sidebarTitle":"Code Execution \u0026 MCP","icon":"terminal","href":"/ja/api-capabilities/grok/code-execution-mcp"},{"title":"Grok マルチエージェントモデルガイド","sidebarTitle":"マルチエージェントモデル","icon":"users","href":"/ja/api-capabilities/grok/multi-agent"},{"title":"Grok プロンプトキャッシュ課金ガイド","sidebarTitle":"キャッシュ課金","icon":"database","href":"/ja/api-capabilities/grok/prompt-caching"}]},{"group":"テキストAPIベストプラクティス","icon":"book-check","pages":[{"title":"長文出力の実践方法","sidebarTitle":"長文出力","icon":"book-check","href":"/ja/api-capabilities/long-form-output-practices"},{"title":"マルチターン会話ガイド","sidebarTitle":"マルチターン会話","icon":"messages-square","href":"/ja/api-capabilities/multi-turn-conversation"},{"group":"テキスト よくある質問","icon":"circle-question-mark","expanded":false,"pages":[{"title":"推論モデルが空のコンテンツを返すのはなぜですか?","icon":"alert-circle","href":"/ja/faq/reasoning-model-empty-response"},{"title":"ストリーミング呼び出しと非ストリーミング呼び出しの違いは何ですか?","sidebarTitle":"ストリーミング vs 非ストリーミング","icon":"audio-lines","href":"/ja/faq/streaming-vs-non-streaming"},{"title":"max_tokens とは? 未設定の場合はどうなりますか?","icon":"sliders-horizontal","href":"/ja/faq/max-tokens"},{"title":"APIにはChatGPTのようなメモリがありますか?","icon":"brain","href":"/ja/faq/api-memory"}]}]},{"title":"残高照会 API","icon":"wallet","href":"/ja/api-capabilities/balance-query"},{"title":"ログクエリ API","icon":"file-text","href":"/ja/api-capabilities/log-query"},{"title":"Token 管理 API","icon":"key","href":"/ja/api-capabilities/token-management"},{"title":"廃止予定のモデル","icon":"triangle-alert","href":"/ja/api-capabilities/deprecated-models"}]},{"group":"画像API(公式)","icon":"image","pages":[{"group":"画像APIの基礎","icon":"book-check","pages":[{"title":"画像APIの必須事項とベストプラクティス","sidebarTitle":"必読 \u0026 ベストプラクティス","icon":"book-check","href":"/ja/api-capabilities/image-api-best-practices"},{"title":"画像API接続切断のトラブルシューティング","sidebarTitle":"接続切断","icon":"unplug","href":"/ja/api-capabilities/image-connection-drops"},{"title":"データ到着後も終了しない画像リクエスト","sidebarTitle":"末尾で停止するリクエスト","icon":"hourglass","href":"/ja/api-capabilities/image-tail-stall"},{"title":"画像圧縮と出力解像度","sidebarTitle":"圧縮と解像度","icon":"scaling","href":"/ja/api-capabilities/image-compression-resolution"},{"title":"納得できる画像を得る方法","sidebarTitle":"納得できる画像の取得","icon":"target","href":"/ja/api-capabilities/image-generation-success-tips"},{"title":"安全性による拒否のトラブルシューティング:アブレーションでトリガーワードを特定する","sidebarTitle":"安全性による拒否","icon":"shield-alert","href":"/ja/api-capabilities/image-safety-troubleshooting"},{"title":"長文promptと2段階生成:32K制限はどこから来るのか","sidebarTitle":"長文prompt","icon":"text-quote","href":"/ja/api-capabilities/image-long-prompt"},{"title":"高度な画像生成: ワークフローとリアリズム","sidebarTitle":"高度なワークフロー","icon":"workflow","href":"/ja/api-capabilities/image-advanced-workflow"},{"title":"Image Prompt Doctor Skill","sidebarTitle":"Prompt Doctor Skill","icon":"stethoscope","href":"/ja/api-capabilities/image-prompt-doctor"},{"group":"画像 よくある質問","icon":"circle-question-mark","pages":[{"title":"画像生成後に拒否されることはありますか?","sidebarTitle":"出力画像のレビュー","icon":"shield-alert","href":"/ja/faq/image-output-safety-review"},{"title":"テキストと生成画像の両方を出力する会話型 API はありますか?","sidebarTitle":"1つのAPIでテキスト + 画像","icon":"images","href":"/ja/faq/text-and-image-in-one-api"},{"title":"画像リクエストが応答なしでハングするのに、ログには書き込み失敗と表示されるのはなぜですか?","icon":"hourglass","href":"/ja/faq/image-direct-large-response-stall"},{"title":"プロキシ経由で約90秒後に画像呼び出しが切断されますか?","icon":"unplug","href":"/ja/faq/proxy-idle-timeout-disconnect"},{"title":"生成された画像が参照画像と大きく異なるのはなぜですか?","icon":"image","href":"/ja/faq/image-result-differs-from-reference"},{"title":"画像コンテンツが MIME タイプと一致しないエラーを修正する方法","icon":"image","href":"/ja/faq/image-mime-type-mismatch-with-query"},{"title":"非同期の画像APIはありますか?タスクIDで結果を照会できますか?","icon":"image","href":"/ja/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":"/ja/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":"/ja/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":"/ja/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":"/ja/api-capabilities/gpt-image-2/image-edit"},{"title":"GPT-Image-2.5 / 2 シリーズのエージェントスキル","icon":"blocks","href":"/ja/api-capabilities/gpt-image-2/skills"},{"title":"マスクインペインティングガイド","sidebarTitle":"マスクインペインティング","icon":"brush","href":"/ja/api-capabilities/gpt-image-2/mask-editing"},{"title":"GPT-Image レガシーバージョン","sidebarTitle":"GPT-Image レガシー","icon":"rotate-ccw-clock","href":"/ja/api-capabilities/gpt-image-2/historical-versions"},{"group":"GPT-Image よくある質問","icon":"circle-question-mark","expanded":false,"pages":[{"title":"SVG生成で使用できる推論 effort の値は何ですか?","icon":"sliders-horizontal","href":"/ja/faq/gpt-image-svg-reasoning-effort"},{"title":"背景が透明な画像(PNG切り抜き)を生成するにはどうすればよいですか?","icon":"layers","href":"/ja/faq/image-transparent-background"},{"title":"GPT Image の出力 token がなぜこんなに多いのですか?","icon":"calculator","href":"/ja/faq/gpt-image-output-token-calculation"},{"title":"GPT-Image の Codex 統合が誤った API キーで失敗する","sidebarTitle":"画像キーが OpenAI に拒否される","icon":"key-round","href":"/ja/faq/gpt-image-incorrect-api-key-openai"}]}]},{"title":"GPT-image-2.5 / 2 公式版とリバース版","sidebarTitle":"GPT-image-2.5 / 2 公式版とリバース版","icon":"scale","href":"/ja/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":"/ja/api-capabilities/gpt-image-2-all/overview"},{"title":"Text-to-Image API リファレンス","openapi":"api-reference/gpt-image-2-all-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ja/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":"/ja/api-capabilities/gpt-image-2-all/image-edit"},{"title":"GPT-Image-2.5-All エージェントスキル","icon":"blocks","href":"/ja/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":"/ja/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":"/ja/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":"/ja/api-capabilities/gpt-image-2-vip/image-edit"},{"title":"GPT-Image-2.5-VIP エージェントスキル","icon":"blocks","href":"/ja/api-capabilities/gpt-image-2-vip/skills"}]},{"title":"Nano Bananaシリーズの料金","icon":"tag","href":"/ja/api-capabilities/nano-banana-pricing"},{"group":"NanoBananaベストプラクティス","icon":"lightbulb","pages":[{"title":"Nano Banana シリーズ開発者ガイド","icon":"compass","href":"/ja/api-capabilities/nano-banana-dev-guide"},{"title":"使用フィールドと出力の解説","sidebarTitle":"使用フィールドと出力の解説","icon":"receipt-text","href":"/ja/api-capabilities/nano-banana-usage-metadata"},{"title":"Gemini 画像生成 API エラーハンドリングガイド","icon":"triangle-alert","href":"/ja/api-capabilities/gemini-image-error-handling"},{"title":"マルチ画像フュージョン テストガイド","sidebarTitle":"マルチ画像フュージョン テスト","icon":"layers","href":"/ja/api-capabilities/multi-image-fusion-testing"},{"title":"Nano Banana Pro 失敗生成クレジット返還プラン","icon":"shield-check","href":"/ja/api-capabilities/nano-banana-pro-guarantee"},{"title":"Nano Banana OSS グループ","icon":"link","href":"/ja/api-capabilities/nano-banana-oss-group"},{"group":"NB よくある質問","icon":"circle-question-mark","pages":[{"title":"Google モデルは AI Studio 上で動作しますか、それとも Vertex ですか?","icon":"split","href":"/ja/faq/google-upstream-aistudio-vertex"},{"title":"画像編集で「Unable to Process Input Image」が返される場合の対処法","icon":"image-off","href":"/ja/faq/gemini-empty-inlinedata"},{"title":"なぜ Gemini 画像で IMAGE_OTHER が返されるのか?","sidebarTitle":"IMAGE_OTHER","icon":"image-minus","href":"/ja/faq/gemini-image-other"},{"title":"なぜGemini画像モデルはblockReason: OTHERを返すのか?","sidebarTitle":"blockReason: OTHER","icon":"shield-alert","href":"/ja/faq/gemini-image-input-blocked"},{"title":"Nano Banana 画像生成失敗の一般的な理由","icon":"image-off","href":"/ja/faq/nano-banana-image-failure"},{"title":"Gemini 画像 API が NO_IMAGE を返すのはなぜですか?","icon":"image-off","href":"/ja/faq/gemini-no-image"},{"title":"Nano Banana Pro で編集したあとに画像が赤っぽくなるのはなぜですか?","icon":"image","href":"/ja/faq/banana-pro-edit-red-cast"},{"title":"Nano Banana Proで衣装を変更したときにプリントの歪みを修正するには?","icon":"shirt","href":"/ja/faq/nano-banana-pro-print-distortion"},{"title":"なぜ白背景の画像に黒い斑点、汚れのような部分、またはぼやけた色ブロックが表示されるのですか?","icon":"triangle-alert","href":"/ja/faq/white-background-image-artifacts"}]}]},{"group":"Nano Banana 2.1画像生成","icon":"banana","pages":[{"title":"Nano Banana 2.1 画像生成/編集","icon":"banana","href":"/ja/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":"/ja/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":"/ja/api-capabilities/gemini-nano-banana-2.1/image-edit"},{"title":"Nano Banana 2.1 エージェントスキル","icon":"blocks","href":"/ja/api-capabilities/gemini-nano-banana-2.1/skills"}]},{"group":"Nano Banana Pro画像生成","icon":"banana","pages":[{"title":"Nano Banana Pro 画像生成","icon":"banana","href":"/ja/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":"/ja/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":"/ja/api-capabilities/nano-banana-image/image-edit"},{"title":"Nano Banana Pro エージェントスキル","icon":"blocks","href":"/ja/api-capabilities/nano-banana-image/skills"}]},{"group":"Nano Banana 2画像生成","icon":"banana","pages":[{"title":"Nano Banana 2 画像生成/編集","icon":"banana","href":"/ja/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":"/ja/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":"/ja/api-capabilities/nano-banana-2-image/image-edit"},{"title":"Nano Banana 2 エージェントスキル","icon":"blocks","href":"/ja/api-capabilities/nano-banana-2-image/skills"}]},{"group":"Nano Banana Lite画像生成","icon":"banana","pages":[{"title":"Nano Banana Lite 画像生成/編集","icon":"banana","href":"/ja/api-capabilities/nano-banana-lite-image/overview"},{"title":"Text-to-Image 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":"/ja/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":"/ja/api-capabilities/nano-banana-lite-image/image-edit"},{"title":"Nano Banana Lite エージェントスキル","icon":"blocks","href":"/ja/api-capabilities/nano-banana-lite-image/skills"}]},{"group":"FLUX画像生成・編集","icon":"sparkles","pages":[{"title":"FLUX 画像生成・編集","sidebarTitle":"FLUX 概要","icon":"sparkles","href":"/ja/api-capabilities/flux/overview"},{"title":"テキストから画像生成 API リファレンス","openapi":"api-reference/flux-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ja/api-capabilities/flux/text-to-image"},{"title":"画像編集 API リファレンス","openapi":"api-reference/flux-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ja/api-capabilities/flux/image-edit"},{"title":"FLUX の過去バージョン","sidebarTitle":"過去バージョン","icon":"rotate-ccw-clock","href":"/ja/api-capabilities/flux/historical-versions"}]},{"group":"Seedream 5.0シリーズ","icon":"sparkles","pages":[{"title":"Seedream 画像生成と編集","sidebarTitle":"Seedream 概要","icon":"sparkles","href":"/ja/api-capabilities/seedream-image/overview"},{"title":"テキストから画像生成 API リファレンス","openapi":"api-reference/seedream-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ja/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":"/ja/api-capabilities/seedream-image/image-edit"},{"title":"Seedream 歴代バージョン","sidebarTitle":"歴代バージョン","icon":"rotate-ccw-clock","href":"/ja/api-capabilities/seedream-image/historical-versions"}]},{"group":"Grok Imagine 公式画像生成","icon":"sparkles","pages":[{"title":"Grok Imagine 公式画像生成","sidebarTitle":"Grok Imagine 公式概要","icon":"sparkles","href":"/ja/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":"/ja/api-capabilities/grok-imagine-image-official/text-to-image"}]},{"group":"Grok Imagine リバース画像生成・編集","icon":"sparkles","pages":[{"title":"Grok Imagine リバース画像生成と編集","sidebarTitle":"Grok Imagine リバース概要","description":"APIYIにおけるxAIの最新世代画像モデル「Grok Imagine 2」(grok-imagine-image / grok-imagine-image-quality)の完全ガイドです。5つのアスペクト比、1K/2Kティア、1回の呼び出しあたり最大10枚の画像、本格的なリファレンス画像編集に対応し、解像度に関わらず1枚あたり一律$0.02 / $0.045(2Kでは定価の約64%)です。デフォルトでは開放されておらず、アクセスには専用のGrok_imagine_Reverseグループが必要です。","icon":"sparkles","href":"/ja/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":"/ja/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":"/ja/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":"/ja/api-capabilities/mai-image/overview"},{"title":"テキストから画像生成 API リファレンス","openapi":"api-reference/mai-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ja/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":"/ja/api-capabilities/mai-image/image-edit"}]},{"title":"APIYI 画像 API 統合実践: 独自の非同期キューを構築する","sidebarTitle":"セルフホストの非同期キュー","icon":"list-checks","href":"/ja/api-capabilities/image-async-queue"}]},{"group":"動画API(公式)","icon":"video","pages":[{"group":"Seedance 2.0 / 2.5(Volcano Engine)","icon":"film","pages":[{"title":"Seedance 2.0 / 2.5 動画生成","sidebarTitle":"Seedance 2.0 / 2.5 概要","icon":"film","href":"/ja/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":"/ja/api-capabilities/seedance2/video-generation"},{"title":"Seedance 2.0 動画エージェントスキル","icon":"blocks","href":"/ja/api-capabilities/seedance2/skills"},{"title":"Seedance 2.0 アセットライブラリ(キャラクター一貫動画)","sidebarTitle":"アセットライブラリ","icon":"images","href":"/ja/api-capabilities/seedance2/asset-library"},{"title":"コードでのアセット参照動画生成","sidebarTitle":"アセット参照ガイド","icon":"clapperboard","href":"/ja/api-capabilities/seedance2/asset-reference"},{"title":"アセット優先:画像と動画の入力をより高速かつ確実に","sidebarTitle":"アセット優先ワークフロー","icon":"gauge","href":"/ja/api-capabilities/seedance2/asset-first-workflow"},{"group":"SD よくある質問","icon":"circle-question-mark","pages":[{"title":"Seedanceで「最初/最後のフレームは参照メディアと混在できません」と表示される","sidebarTitle":"最初のフレームと参照の混在","icon":"layers","href":"/ja/faq/seedance-first-frame-mixed-with-reference"},{"title":"Seedanceで「invalid image format」と表示されるが、ブラウザではリンクが開ける","sidebarTitle":"画像リンクは開けるが失敗する","icon":"link","href":"/ja/faq/seedance-image-url-invalid-format"},{"title":"Seedance 2.5:参照から動画への変換と動画編集","icon":"split","href":"/ja/faq/seedance2-reference-vs-edit"},{"title":"Seedance 動画タスクは送信後にキャンセルできますか?","icon":"video","href":"/ja/faq/seedance-video-task-cancel"},{"title":"task_id で Seedance 動画の実際のコストを確認する方法","icon":"receipt","href":"/ja/faq/seedance-task-cost-lookup"},{"title":"Seedance 2.0は顔のリファレンスをアセットライブラリに自動アップロードしますか?ディープフェイクフィルターが作動しますか?","icon":"banana","href":"/ja/faq/seedance2-asset-face-reference"},{"title":"Seedance 2.0 / 2.5で顔アセットがブロックされるのはなぜですか?","icon":"scan-face","href":"/ja/faq/seedance2-face-asset-whitelist"}]}]},{"group":"Wan3.0動画生成(Alibaba Cloud)","icon":"video","pages":[{"title":"Wan3.0 動画生成 (Alibaba Tongyi Wanxiang)","sidebarTitle":"概要","icon":"video","href":"/ja/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":"/ja/api-capabilities/wan3/video-generation"},{"title":"Wan3.0 のダウンロードに失敗しました: ソースメディア URL が失敗する理由と解決方法","sidebarTitle":"メディアのダウンロード失敗","icon":"circle-question-mark","href":"/ja/faq/wan3-media-download-failed"}]},{"group":"Wan2.7動画生成(Alibaba Cloud)","icon":"videotape","pages":[{"title":"Wan 動画生成(Alibaba Cloud Tongyi Wanxiang)","sidebarTitle":"Wan 概要","icon":"video","href":"/ja/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":"/ja/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":"/ja/api-capabilities/wan/image-to-video"},{"title":"Wan2.7-r2v 参照ベース動画生成 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":"/ja/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":"/ja/api-capabilities/wan/video-edit"},{"title":"Wan2.7 と HappyHorse の Video Agent Skill","icon":"blocks","href":"/ja/api-capabilities/wan/skills"},{"title":"Wanの過去バージョン (Wan2.6)","sidebarTitle":"過去バージョン","icon":"rotate-ccw-clock","href":"/ja/api-capabilities/wan/historical-versions"}]},{"group":"HappyHorse動画生成(Alibaba Cloud)","icon":"monitor-play","pages":[{"title":"HappyHorse 動画生成 (Alibaba Cloud)","sidebarTitle":"HappyHorse の概要","icon":"monitor-play","href":"/ja/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":"/ja/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":"/ja/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":"/ja/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":"/ja/api-capabilities/happyhorse/video-edit"},{"title":"HappyHorse 動画エージェントスキル","icon":"blocks","href":"/ja/api-capabilities/happyhorse/skills"}]},{"group":"Grok Imagine 動画生成(xAI)","icon":"camera","pages":[{"title":"Grok Imagine 動画生成","sidebarTitle":"Grok Imagine 動画の概要","icon":"video","href":"/ja/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":"/ja/api-capabilities/grok-imagine-video/video-generation"}]},{"group":"MiniMax H3 動画生成(セルフホスト)","icon":"film","pages":[{"title":"MiniMax-H3 動画生成","sidebarTitle":"MiniMax-H3 の概要","icon":"video","href":"/ja/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":"/ja/api-capabilities/minimax-h3/video-generation"}]},{"group":"Oxygen 動画生成(AZ8)","icon":"clapperboard","pages":[{"title":"Oxygen 動画生成","sidebarTitle":"Oxygen 概要","icon":"video","href":"/ja/api-capabilities/oxygen/overview"},{"title":"Oxygen 動画生成 API リファレンス","sidebarTitle":"動画生成","openapi":"api-reference/oxygen-video-openapi-en.yaml POST /videos","icon":"video","href":"/ja/api-capabilities/oxygen/video-generation"}]}]},{"group":"マルチモーダル理解API","icon":"eye","pages":[{"group":"画像理解API","icon":"eye","root":{"title":"ビジョン理解(画像認識)API","icon":"eye","href":"/ja/api-capabilities/vision-understanding"},"pages":[{"group":"画像理解 よくある質問","icon":"circle-help","expanded":false,"pages":[{"title":"画像理解リクエストがタイムアウトし続ける — 画像が大きすぎますか?","icon":"image","href":"/ja/faq/vision-image-too-large"}]}]},{"title":"動画理解 API","icon":"video","href":"/ja/api-capabilities/video-understanding"}]},{"group":"テキスト生成","icon":"file-text","pages":[{"title":"テキスト生成(チャット補完)","icon":"message-square","href":"/ja/api-capabilities/text-generation"},{"group":"Gemini 4 Carbon","icon":"sparkles","pages":[{"title":"Gemini 4 Carbon テキスト生成","sidebarTitle":"Gemini 4 Carbon 概要","icon":"sparkles","href":"/ja/api-capabilities/gemini-4-carbon/overview"}]},{"group":"Gemini 4 Argon","icon":"sparkles","pages":[{"title":"Gemini 4 Argon テキスト生成","sidebarTitle":"Gemini 4 Argon 概要","icon":"sparkles","href":"/ja/api-capabilities/gemini-4-argon/overview"}]},{"group":"GPT-6 Astra","icon":"sparkles","pages":[{"title":"GPT-6 Astra テキスト生成","sidebarTitle":"GPT-6 Astra 概要","icon":"sparkles","href":"/ja/api-capabilities/gpt-6-astra/overview"}]},{"group":"DeepSeek V4 Flash Vision","icon":"eye","pages":[{"title":"DeepSeek V4 Flash Vision","sidebarTitle":"概要","icon":"eye","href":"/ja/api-capabilities/deepseek-v4-flash-vision/overview"},{"title":"DeepSeek V4 Flash Vision チャット APIリファレンス","sidebarTitle":"チャットプレイグラウンド","openapi":"api-reference/deepseek-v4-flash-vision-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ja/api-capabilities/deepseek-v4-flash-vision/chat-completions"},{"title":"DeepSeek V4 Flash ビジョン メッセージ API リファレンス","sidebarTitle":"メッセージ プレイグラウンド","openapi":"api-reference/deepseek-v4-flash-vision-messages-openapi-en.yaml POST /v1/messages","icon":"terminal","href":"/ja/api-capabilities/deepseek-v4-flash-vision/messages"}]},{"group":"DeepSeek V4 Flash","icon":"zap","pages":[{"title":"DeepSeek V4 Flash テキスト生成","sidebarTitle":"概要","icon":"zap","href":"/ja/api-capabilities/deepseek-v4-flash/overview"},{"title":"DeepSeek V4 Flash Chat API リファレンス","sidebarTitle":"Chat Playground","openapi":"api-reference/deepseek-v4-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ja/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":"/ja/api-capabilities/deepseek-v4-flash/responses"}]},{"group":"DeepSeek Search \u0026 Fetch","icon":"search","pages":[{"title":"DeepSeek Web Search と Fetch API","sidebarTitle":"概要","icon":"search","href":"/ja/api-capabilities/deepseek-search-fetch/overview"},{"title":"DeepSeek Web 検索 API リファレンス","sidebarTitle":"検索プレイグラウンド","openapi":"api-reference/deepseek-search-openapi-en.yaml POST /v1/tools/search","icon":"terminal","href":"/ja/api-capabilities/deepseek-search-fetch/search-api"},{"title":"DeepSeek Web Fetch API リファレンス","sidebarTitle":"Fetch プレイグラウンド","openapi":"api-reference/deepseek-fetch-openapi-en.yaml POST /v1/tools/fetch","icon":"terminal","href":"/ja/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":"/ja/api-capabilities/dola-seed-2-1-turbo/overview"},{"title":"Seed 2.1 Turbo Chat API リファレンス","sidebarTitle":"Chat Playground","openapi":"api-reference/dola-seed-2-1-turbo-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ja/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":"/ja/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":"/ja/api-capabilities/gemini-3-8-flash/overview"},{"title":"Gemini 3.6 Flash テキスト生成","sidebarTitle":"Gemini 3.6 Flash 概要","icon":"sparkles","href":"/ja/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":"/ja/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":"/ja/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":"/ja/api-capabilities/gemini-3-5-flash-lite/overview"},{"title":"Gemini 3.5 Flash-Lite ネイティブ API リファレンス","sidebarTitle":"ネイティブ Playground","openapi":"api-reference/gemini-3-5-flash-lite-native-openapi-en.yaml POST /v1beta/models/gemini-3.5-flash-lite:generateContent","icon":"terminal","href":"/ja/api-capabilities/gemini-3-5-flash-lite/generate-content"},{"title":"Gemini 3.5 Flash-Lite Chat API リファレンス","sidebarTitle":"Chat プレイグラウンド","openapi":"api-reference/gemini-3-5-flash-lite-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ja/api-capabilities/gemini-3-5-flash-lite/chat-completions"}]},{"group":"Qwen3シリーズ","icon":"puzzle","pages":[{"title":"Qwen3.8-Max テキスト生成","sidebarTitle":"概要","icon":"puzzle","href":"/ja/api-capabilities/qwen-3-8/overview"},{"title":"Qwen3.8-Max Chat API リファレンス","sidebarTitle":"チャットプレイグラウンド","openapi":"api-reference/qwen-3-8-max-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ja/api-capabilities/qwen-3-8/chat-completions"},{"title":"Qwen3.6 テキストモデルシリーズ(レガシー)","sidebarTitle":"Qwen3.6(レガシー)","icon":"puzzle","href":"/ja/api-capabilities/qwen-3-6/overview"}]},{"group":"Kimi K3.1 Pro","icon":"moon","pages":[{"title":"Kimi K3.1 Pro 概要","sidebarTitle":"概要","icon":"brain","href":"/ja/api-capabilities/kimi-k3-1/overview"}]},{"title":"Kimi K2.5 テキスト生成","sidebarTitle":"Kimi K2.5","icon":"bot","href":"/ja/api-capabilities/kimi-k2-5"}]},{"group":"音声API(公式)","icon":"audio-lines","pages":[{"title":"リアルタイム音声(WebSocket)","sidebarTitle":"リアルタイム音声の概要","icon":"audio-lines","href":"/ja/api-capabilities/realtime/overview"}]},{"group":"検索と安全性","icon":"search","pages":[{"title":"テキスト埋め込み API","icon":"vector-square","href":"/ja/api-capabilities/text-embedding"},{"title":"実践的なEmbeddingチューニング","sidebarTitle":"Embeddingチューニング","icon":"sliders-horizontal","href":"/ja/api-capabilities/embedding-best-practices"},{"group":"リランク","icon":"list-ordered","pages":[{"title":"bge-reranker-v2-m3 テキスト再ランキング","sidebarTitle":"概要","icon":"list-ordered","href":"/ja/api-capabilities/rerank/overview"},{"title":"再ランキング API リファレンス","sidebarTitle":"プレイグラウンド","openapi":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml POST /v1/rerank","icon":"terminal","href":"/ja/api-capabilities/rerank/rerank-api"},{"title":"実践における RAG チューニング","sidebarTitle":"RAG チューニング","icon":"sliders-horizontal","href":"/ja/api-capabilities/rerank/rag-best-practices"}]},{"title":"テキストモデレーション","icon":"shield-check","href":"/ja/api-capabilities/text-moderation"}]}]},{"tab":"活用例","icon":"layout-grid","pages":[{"title":"活用例","href":"/ja/scenarios"}]},{"tab":"FAQ","icon":"circle-question-mark","pages":[{"title":"FAQ","href":"/ja/faq"}]},{"tab":"更新情報","icon":"activity","pages":[{"title":"更新情報","href":"/ja/live"}]},{"tab":"お知らせ","icon":"megaphone","pages":[{"title":"お知らせ","href":"/ja/changelog"}]},{"tab":"プロモーション","icon":"gift","pages":[{"title":"プロモーション","href":"/ja/faq/recharge-promotions"}]},{"tab":"モデル料金","icon":"circle-dollar-sign","pages":[{"title":"モデル料金","href":"/ja/models"}]}]},{"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"}},"pages":[{"title":"ko","href":"/ko/api-capabilities/grok-imagine-image/text-to-image"}]},{"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"]}