{ "error": { "code": 401, "message": "Authentication failed. Please check your API key", "type": "authentication_error" }}
{ "error": { "code": 402, "message": "Insufficient balance. Please top up and try again", "type": "payment_required" }}
{ "error": { "code": 429, "message": "Too many requests. Please try again later", "type": "rate_limit_error" }}
Texto a imagen · tareas asíncronas. Envíe POST /v1/images/generations y, a continuación, consulte Obtener estado de la tarea.
El nombre del modelo es fijo: grok-imagine-2.0-ext. No admitido: imágenes de referencia, stream ni valores de response_format distintos de url.
No ponga claves de API en bundles del navegador (VITE_* / NEXT_PUBLIC_*, LocalStorage, etc.). Prefiera llamar a su propio BFF desde el navegador; mantenga la clave de APIMart en el servidor.
curl --request POST \ --url https://api.apimart.ai/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Idempotency-Key: 8eacb46d-ef4e-4f4e-82de-830bd8bc67e2' \ --header 'X-APIMart-Response-Version: 2026-07-27' \ --data '{ "model": "grok-imagine-2.0-ext", "prompt": "A red apple on a white ceramic plate, clean studio product photo", "n": 1, "size": "1:1", "resolution": "quality", "response_format": "url" }'
import requestsimport uuidurl = "https://api.apimart.ai/v1/images/generations"payload = { "model": "grok-imagine-2.0-ext", "prompt": "A red apple on a white ceramic plate, clean studio product photo", "n": 1, "size": "1:1", "resolution": "quality", "response_format": "url",}headers = { "Authorization": "Bearer <token>", "Content-Type": "application/json", "Accept": "application/json", "Idempotency-Key": str(uuid.uuid4()), "X-APIMart-Response-Version": "2026-07-27",}response = requests.post(url, json=payload, headers=headers)print(response.status_code, response.json())
const url = "https://api.apimart.ai/v1/images/generations";const payload = { model: "grok-imagine-2.0-ext", prompt: "A red apple on a white ceramic plate, clean studio product photo", n: 1, size: "1:1", resolution: "quality", response_format: "url",};const headers = { Authorization: "Bearer <token>", "Content-Type": "application/json", Accept: "application/json", "Idempotency-Key": crypto.randomUUID(), "X-APIMart-Response-Version": "2026-07-27",};fetch(url, { method: "POST", headers: headers, body: JSON.stringify(payload),}) .then(async (response) => { console.log(response.status, await response.json()); }) .catch((error) => console.error("Error:", error));
Relación de aspecto. Prefiera cadenas de proporción (la UI solo debe mostrar proporciones):
size
Orientación
Uso típico
1:1
Cuadrado
Producto, avatar
2:3
Vertical
Póster, cuerpo entero
3:2
Horizontal
Foto, escena amplia
3:4
Vertical
Comercio electrónico, personas
4:3
Horizontal
Arte de visualización
9:16
Vertical
Portada de Story / video corto
16:9
Ancho
Banner, portada de video
Alias de píxeles: 1024x1024 (1:1), 1024x1792 (2:3), 1792x1024 (3:2), 720x1280 (9:16), 1280x720 (16:9).Los valores fuera de la lista blanca devuelven 400 invalid_size (p. ej. 1:2, 2:1, 4:5, auto).
Los píxeles reales de una proporción pueden diferir de la tabla de alias (p. ej. 1:1 puede devolver 1408×1408). Confíe en la imagen devuelta; no reescriba size a partir de los píxeles medidos.
{ "model": "grok-imagine-2.0-ext", "prompt": "A red apple on a white ceramic plate, clean studio product photo", "n": 1, "size": "1:1", "resolution": "quality", "response_format": "url"}
La generación de imágenes es facturable — se recomienda encarecidamenteIdempotency-Key (1–191 caracteres ASCII imprimibles; UUID es lo más sencillo; se retiene ~24 horas).
Escenario
Comportamiento
Acción
Misma key + mismo body ya completado
Replay; header Idempotency-Replayed: true
Use el mismo id de tarea
Misma key aún en curso
409 idempotency_in_progress + Retry-After
Espere y reintente con la misma key y el mismo body
Misma key, body distinto
409 idempotency_key_reused
Una nueva tarea lógica necesita una key nueva
Resultado indeterminado
409 idempotency_result_indeterminate
No cree una key nueva; investigue con la antigua
En un timeout de red del POST cuando no pueda saber si el servidor aceptó la tarea, no cree de inmediato una key nueva — reintente con la misma key / body / versión de respuesta.
Siga consultando (result puede estar ausente — no es un fallo)
completed
Sí
Analice result.images
failed
Sí
Muestre error.message; cost es 0 (pre-cargo reembolsado)
unknown
No
Reintentos cortos; si persiste, contacte a soporte con el id de la tarea
Consulte aproximadamente cada 2 segundos; tope cerca de 10 minutos o 120 intentos. Respete Retry-After en 429. Las tareas se conservan ~3 días por defecto — guarde el id de la tarea si el cliente agota el tiempo de espera.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"APIMart","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"favicon":"https://mintcdn.com/apicore/1GnRrmOhqkTFCvFb/logo/logo.png?fit=max\u0026auto=format\u0026n=1GnRrmOhqkTFCvFb\u0026q=85\u0026s=609be15c3f1f4e4b765c5945c2871ae9","navbar":{"links":[{"icon":"x-twitter","href":"https://x.com/APIMart_","label":""},{"icon":"discord","href":"https://discord.gg/V8zqssyZ5c","label":""},{"icon":"weixin","href":"https://cdn.apimart.ai/social-media/wechat.jpg","label":""}],"primary":{"type":"button","label":"Dashboard","href":"https://apimart.ai"}},"footer":{"socials":{"x":"https://x.com/APIMart_","website":"https://apimart.ai","discord":"https://discord.gg/V8zqssyZ5c"}},"seo":{"metatags":{"og:site_name":"APIMart","og:type":"website","keywords":"OpenAI compatible, API gateway, GPT-5, Claude, Gemini, multi-provider, transparent pricing, SLA","twitter:card":"summary_large_image","twitter:site":"@APIMart_","twitter:creator":"@APIMart_"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"en"},{"language":"zh-Hans","href":"cn"},{"language":"ja","href":"ja"},{"language":"ko","href":"ko"},{"language":"ru","href":"ru"},{"language":"de","href":"de"},{"language":"fr","href":"fr"},{"language":"pt","href":"pt"},{"language":"id","href":"id"},{"language":"es","href":"es"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apicore","hasAudioNarration":false,"actualSubdomain":"apicore","customDomains":["docs.apimart.ai"],"gitSource":{"type":"github","owner":"apimart-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae1c97b1297abb2484bbfc0"},"entitlements":{},"buildId":"6aef1a2ed5518ba96e45fcf6","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"zh-Hans","tag":"API 手册","count":170},{"language":"de","tag":"API-Handbuch","count":170},{"language":"en","tag":"API Manual","count":170},{"language":"es","tag":"Manual de la API","count":170},{"language":"fr","tag":"Manuel API","count":170},{"language":"id","tag":"Panduan API","count":170},{"language":"ja","tag":"APIマニュアル","count":170},{"language":"ko","tag":"API 매뉴얼","count":170},{"language":"pt","tag":"Manual da API","count":170},{"language":"ru","tag":"Руководство API","count":170},{"language":"zh-Hans","tag":"图像系列","count":52},{"language":"de","tag":"Bildserie","count":52},{"language":"en","tag":"Image Series","count":52},{"language":"es","tag":"Serie de imágenes","count":52},{"language":"fr","tag":"Série Image","count":52},{"language":"id","tag":"Seri Gambar","count":52},{"language":"ja","tag":"画像シリーズ","count":52},{"language":"ko","tag":"이미지 시리즈","count":52},{"language":"pt","tag":"Série de Imagem","count":52},{"language":"ru","tag":"Серия изображений","count":52},{"language":"zh-Hans","tag":"音频系列","count":51},{"language":"de","tag":"Audioserie","count":51},{"language":"en","tag":"Audio Series","count":51},{"language":"es","tag":"Serie de audio","count":51},{"language":"fr","tag":"Série Audio","count":51},{"language":"id","tag":"Seri Audio","count":51},{"language":"ja","tag":"オーディオシリーズ","count":51},{"language":"ko","tag":"오디오 시리즈","count":51},{"language":"pt","tag":"Série de Áudio","count":51},{"language":"ru","tag":"Аудиосерия","count":51},{"language":"zh-Hans","tag":"视频系列","count":46},{"language":"de","tag":"Videoserie","count":46},{"language":"en","tag":"Video Series","count":46},{"language":"es","tag":"Serie de video","count":46},{"language":"fr","tag":"Série Vidéo","count":46},{"language":"id","tag":"Seri Video","count":46},{"language":"ja","tag":"動画シリーズ","count":46},{"language":"ko","tag":"비디오 시리즈","count":46},{"language":"pt","tag":"Série de Vídeo","count":46},{"language":"ru","tag":"Видеосерия","count":46},{"language":"zh-Hans","tag":"Suno","count":35},{"language":"de","tag":"Suno","count":35},{"language":"en","tag":"Suno","count":35},{"language":"es","tag":"Suno","count":35},{"language":"fr","tag":"Suno","count":35},{"language":"id","tag":"Suno","count":35},{"language":"ja","tag":"Suno","count":35},{"language":"ko","tag":"Suno","count":35},{"language":"pt","tag":"Suno","count":35},{"language":"ru","tag":"Suno","count":35},{"language":"zh-Hans","tag":"Midjourney","count":19},{"language":"de","tag":"Midjourney","count":19},{"language":"en","tag":"Midjourney","count":19},{"language":"es","tag":"Midjourney","count":19},{"language":"fr","tag":"Midjourney","count":19},{"language":"id","tag":"Midjourney","count":19},{"language":"ja","tag":"Midjourney","count":19},{"language":"ko","tag":"Midjourney","count":19},{"language":"pt","tag":"Midjourney","count":19},{"language":"ru","tag":"Midjourney","count":19},{"language":"zh-Hans","tag":"Flow Music","count":14},{"language":"de","tag":"Flow Music","count":14},{"language":"en","tag":"Flow Music","count":14},{"language":"es","tag":"Flow Music","count":14},{"language":"fr","tag":"Flow Music","count":14},{"language":"id","tag":"Flow Music","count":14},{"language":"ja","tag":"Flow Music","count":14},{"language":"ko","tag":"Flow Music","count":14},{"language":"pt","tag":"Flow Music","count":14},{"language":"ru","tag":"Flow Music","count":14},{"language":"ja","tag":"よくある質問","count":12},{"language":"ko","tag":"자주 묻는 질문","count":12},{"language":"zh-Hans","tag":"集成指南","count":11},{"language":"de","tag":"Integrationen","count":11},{"language":"en","tag":"Integrations","count":11},{"language":"es","tag":"Integraciones","count":11},{"language":"fr","tag":"Intégrations","count":11},{"language":"id","tag":"Integrasi","count":11},{"language":"ja","tag":"統合ガイド","count":11},{"language":"ko","tag":"통합 가이드","count":11},{"language":"pt","tag":"Integrações","count":11},{"language":"ru","tag":"Интеграции","count":11},{"language":"zh-Hans","tag":"文字系列","count":10},{"language":"de","tag":"Textserie","count":10},{"language":"en","tag":"Text Series","count":10},{"language":"es","tag":"Serie de texto","count":10},{"language":"fr","tag":"Série Texte","count":10},{"language":"id","tag":"Seri Teks","count":10},{"language":"ja","tag":"テキストシリーズ","count":10},{"language":"ko","tag":"텍스트 시리즈","count":10},{"language":"pt","tag":"Série de Texto","count":10},{"language":"ru","tag":"Текстовая серия","count":10},{"language":"zh-Hans","tag":"概览","count":7},{"language":"de","tag":"Übersicht","count":7},{"language":"en","tag":"Overview","count":7},{"language":"es","tag":"Visión general","count":7},{"language":"fr","tag":"Aperçu","count":7},{"language":"id","tag":"Ikhtisar","count":7},{"language":"pt","tag":"Visão Geral","count":7},{"language":"ru","tag":"Обзор","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[id^=\"param-\"] a[href^=\"#param-\"]{display:none}[id^=\"param-\"] button[data-component-part=\"field-name\"]{display:inline-flex;align-items:center;gap:6px;margin:-2px -4px;padding:2px 4px;border-radius:6px;cursor:copy;user-select:text;transition:background-color 150ms ease}[id^=\"param-\"] button[data-component-part=\"field-name\"]:hover{background:rgb(37 99 235 / 8%)}[id^=\"param-\"] button[data-component-part=\"field-name\"]:not([data-copy-state])::after{content:\"\";display:inline-block;flex:0 0 auto;width:16px;height:16px;background-color:rgb(100 116 139);-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;transition:background-color 150ms ease}[id^=\"param-\"] button[data-component-part=\"field-name\"]:hover::after{background-color:rgb(37 99 235)}[id^=\"param-\"] button[data-component-part=\"field-name\"][data-copy-state=\"copied\"]::after{content:\"\";display:inline-block;flex:0 0 auto;width:16px;height:16px;background-color:rgb(5 150 105);-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.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='m5 12 4 4L19 6'/%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.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='m5 12 4 4L19 6'/%3E%3C/svg%3E\") center / contain no-repeat}[id^=\"param-\"] button[data-component-part=\"field-name\"][data-copy-state=\"failed\"]::after{content:\"\";display:inline-block;flex:0 0 auto;width:16px;height:16px;background-color:rgb(220 38 38);-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.5' stroke-linecap='round'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%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.5' stroke-linecap='round'%3E%3Cpath d='M18 6 6 18M6 6l12 12'/%3E%3C/svg%3E\") center / contain no-repeat}html.dark [id^=\"param-\"] button[data-component-part=\"field-name\"]:not([data-copy-state])::after{background-color:rgb(203 213 225)}"}],"page":{"pagePath":"es/api-reference/images/grok-imagine-2.0-ext/generation","slug":"/es/api-reference/images/grok-imagine-2.0-ext/generation","pageMetadata":{"title":"Grok Imagine 2.0 Ext generación de imágenes","description":" - Texto a imagen asíncrono; consulte con task_id\n- 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una)\n- Salida solo en URL; sin imagen a imagen / streaming\n- Las URL de imagen expiran en 72 horas ","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/generation"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Texto a imagen asíncrono; consulte con task_id\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Salida solo en URL; sin imagen a imagen / streaming\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Las URL de imagen expiran en 72 horas\"\n }), \"\\n\"]\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`,br:`br`,code:`code`,li:`li`,ol:`ol`,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,Note,ParamField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Texto a imagen · tareas asíncronas.`}),` Envíe `,_jsx(_components.code,{children:`POST /v1/images/generations`}),` y, a continuación, consulte `,_jsx(_components.a,{href:`/es/api-reference/tasks/status`,children:`Obtener estado de la tarea`}),`.`,_jsx(_components.br,{}),`\n`,`El nombre del modelo es fijo: `,_jsx(_components.code,{children:`grok-imagine-2.0-ext`}),`. `,_jsx(_components.strong,{children:`No admitido`}),`: imágenes de referencia, `,_jsx(_components.code,{children:`stream`}),` ni valores de `,_jsx(_components.code,{children:`response_format`}),` distintos de `,_jsx(_components.code,{children:`url`}),`.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Para trabajar con capas de objetos o editar regiones seleccionadas, consulta `,_jsx(_components.a,{href:`/es/api-reference/images/grok-imagine-2.0-ext/layer-region-edit`,children:`Capas y edición de regiones`}),`.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`No ponga claves de API en bundles del navegador (`,_jsx(_components.code,{children:`VITE_*`}),` / `,_jsx(_components.code,{children:`NEXT_PUBLIC_*`}),`, LocalStorage, etc.). Prefiera llamar a su propio BFF desde el navegador; mantenga la clave de APIMart en el servidor.`]})}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`capacidades-y-límites`,children:`Capacidades y límites`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Dimensión`}),_jsx(_components.th,{children:`Contrato`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Modelo`}),_jsxs(_components.td,{children:[`Fijo `,_jsx(_components.code,{children:`grok-imagine-2.0-ext`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Capacidad`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Solo texto a imagen`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Modo`}),_jsx(_components.td,{children:`Tarea asíncrona`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Cantidad `,_jsx(_components.code,{children:`n`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1`}),`–`,_jsx(_components.code,{children:`12`}),`, valor predeterminado `,_jsx(_components.code,{children:`1`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`size`})}),_jsx(_components.td,{children:`7 relaciones de aspecto + 5 alias de píxeles (abajo)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Salida`}),_jsxs(_components.td,{children:[`Solo `,_jsx(_components.code,{children:`response_format=url`}),` (también el valor predeterminado)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Calidad`}),_jsxs(_components.td,{children:[`Campo público `,_jsx(_components.code,{children:`resolution`}),`; valor verificado `,_jsx(_components.code,{children:`quality`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No admitido`}),_jsxs(_components.td,{children:[`Imagen a imagen, `,_jsx(_components.code,{children:`stream=true`}),`, `,_jsx(_components.code,{children:`quality`}),` público, `,_jsx(_components.code,{children:`style`}),`, `,_jsx(_components.code,{children:`b64_json`}),` / `,_jsx(_components.code,{children:`base64`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Facturación`}),_jsxs(_components.td,{children:[`Precio unitario fijo; se cobra por imágenes `,_jsx(_components.strong,{children:`entregadas con éxito`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`autenticación-y-headers-recomendados`,children:`Autenticación y headers recomendados`}),`\n`,_jsxs(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:[_jsxs(_components.p,{children:[`Token Bearer. Obtenga una clave en la `,_jsx(_components.a,{href:`https://apimart.ai/keys`,children:`página de API Key`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Bearer YOUR_API_KEY`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Notas`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`application/json`}),` (envío)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Accept`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Idempotency-Key`})}),_jsxs(_components.td,{children:[`Muy recomendado. Nuevo UUID por generación confirmada por el usuario; los reintentos de red `,_jsx(_components.strong,{children:`deben reutilizar`}),` la misma key y el mismo body`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-APIMart-Response-Version`})}),_jsxs(_components.td,{children:[`Prefiera `,_jsx(_components.code,{children:`2026-07-27`}),` para una forma de envío estable (`,_jsx(_components.code,{children:`data.id`}),`)`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`parámetros-de-la-solicitud`,children:`Parámetros de la solicitud`}),`\n`,_jsx(ParamField,{body:`model`,type:`string`,required:true,id:`param-model`,children:_jsxs(_components.p,{children:[`Valor fijo: `,_jsx(_components.code,{children:`grok-imagine-2.0-ext`})]})}),`\n`,_jsxs(ParamField,{body:`nsfw_check`,type:`boolean`,default:`false`,id:`param-nsfw-check`,children:[_jsx(_components.p,{children:`Indica si se debe moderar el contenido antes de enviar la tarea de imagen.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`true`}),`: revisar los prompts y las imágenes de entrada con `,_jsx(_components.code,{children:`omni-moderation-latest`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`false`}),` u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)`]}),`\n`]})]}),`\n`,_jsx(ParamField,{body:`prompt`,type:`string`,required:true,id:`param-prompt`,children:_jsx(_components.p,{children:`Prompt. Debe ser no vacío tras el trim. Haga trim antes de enviar.`})}),`\n`,_jsx(ParamField,{body:`n`,type:`integer`,default:`1`,id:`param-n`,children:_jsxs(_components.p,{children:[`Cantidad de imágenes: `,_jsx(_components.code,{children:`1`}),`–`,_jsx(_components.code,{children:`12`}),`. Un `,_jsx(_components.code,{children:`0`}),` explícito produce error. Omítalo para `,_jsx(_components.code,{children:`1`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`size`,type:`string`,id:`param-size`,children:[_jsxs(_components.p,{children:[`Relación de aspecto. `,_jsx(_components.strong,{children:`Prefiera cadenas de proporción`}),` (la UI solo debe mostrar proporciones):`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`size`})}),_jsx(_components.th,{children:`Orientación`}),_jsx(_components.th,{children:`Uso típico`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1:1`})}),_jsx(_components.td,{children:`Cuadrado`}),_jsx(_components.td,{children:`Producto, avatar`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2:3`})}),_jsx(_components.td,{children:`Vertical`}),_jsx(_components.td,{children:`Póster, cuerpo entero`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3:2`})}),_jsx(_components.td,{children:`Horizontal`}),_jsx(_components.td,{children:`Foto, escena amplia`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3:4`})}),_jsx(_components.td,{children:`Vertical`}),_jsx(_components.td,{children:`Comercio electrónico, personas`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`4:3`})}),_jsx(_components.td,{children:`Horizontal`}),_jsx(_components.td,{children:`Arte de visualización`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`9:16`})}),_jsx(_components.td,{children:`Vertical`}),_jsx(_components.td,{children:`Portada de Story / video corto`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`16:9`})}),_jsx(_components.td,{children:`Ancho`}),_jsx(_components.td,{children:`Banner, portada de video`})]})]})]}),_jsxs(_components.p,{children:[`Alias de píxeles: `,_jsx(_components.code,{children:`1024x1024`}),` (1:1), `,_jsx(_components.code,{children:`1024x1792`}),` (2:3), `,_jsx(_components.code,{children:`1792x1024`}),` (3:2), `,_jsx(_components.code,{children:`720x1280`}),` (9:16), `,_jsx(_components.code,{children:`1280x720`}),` (16:9).`]}),_jsxs(_components.p,{children:[`Los valores fuera de la lista blanca devuelven `,_jsx(_components.code,{children:`400 invalid_size`}),` (p. ej. `,_jsx(_components.code,{children:`1:2`}),`, `,_jsx(_components.code,{children:`2:1`}),`, `,_jsx(_components.code,{children:`4:5`}),`, `,_jsx(_components.code,{children:`auto`}),`).`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Los píxeles reales de una proporción pueden diferir de la tabla de alias (p. ej. `,_jsx(_components.code,{children:`1:1`}),` puede devolver 1408×1408). Confíe en la imagen devuelta; no reescriba `,_jsx(_components.code,{children:`size`}),` a partir de los píxeles medidos.`]})})]}),`\n`,_jsxs(ParamField,{body:`resolution`,type:`string`,id:`param-resolution`,children:[_jsxs(_components.p,{children:[`Campo de modo de calidad. Valor verificado: `,_jsx(_components.code,{children:`quality`}),`.`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Omítalo (el modelo es modo calidad por defecto), o`}),`\n`,_jsxs(_components.li,{children:[`Pase `,_jsx(_components.code,{children:`resolution: \"quality\"`}),` de forma explícita`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`No`}),` es un nivel de píxeles `,_jsx(_components.code,{children:`1K`}),` / `,_jsx(_components.code,{children:`2K`}),` / `,_jsx(_components.code,{children:`4K`}),`; el encuadre lo controla `,_jsx(_components.code,{children:`size`}),`.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`No envíe el campo público `,_jsx(_components.code,{children:`quality`}),` — recibirá `,_jsx(_components.code,{children:`400 invalid_quality`}),`. Use `,_jsx(_components.code,{children:`resolution`}),`.`]})})]}),`\n`,_jsx(ParamField,{body:`response_format`,type:`string`,default:`url`,id:`param-response-format`,children:_jsxs(_components.p,{children:[`Solo se permite `,_jsx(_components.code,{children:`url`}),`. Puede omitirse. `,_jsx(_components.code,{children:`b64_json`}),` / `,_jsx(_components.code,{children:`base64`}),` → `,_jsx(_components.code,{children:`400 invalid_response_format`}),`.`]})}),`\n`,_jsx(ParamField,{body:`webhook`,type:`string`,id:`param-webhook`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`URL base`}),` HTTPS pública opcional. En estado terminal, la plataforma hace POST a `,_jsx(_components.code,{children:`{webhook}/callback`}),`. Solo en el servidor — vea `,_jsx(_components.a,{href:`#webhook-opcional`,children:`Webhook`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`parámetros-no-admitidos`,children:`Parámetros no admitidos`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parámetro`}),_jsx(_components.th,{children:`Comportamiento`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quality`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`400 invalid_quality`}),` → use `,_jsx(_components.code,{children:`resolution`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`style`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_style`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`image_urls`}),` / `,_jsx(_components.code,{children:`image_with_roles`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_image_input`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stream: true`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_stream`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`response_format: \"b64_json\"`}),` / `,_jsx(_components.code,{children:`\"base64\"`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_response_format`})})]})]})]}),`\n`,_jsx(_components.p,{children:`Construya las solicitudes con una lista blanca; no reenvíe un objeto de formulario genérico de otros modelos de imagen.`}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplos-de-solicitud`,children:`Ejemplos de solicitud`}),`\n`,_jsx(Heading,{level:`3`,id:`mínimo`,children:`Mínimo`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,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:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"grok-imagine-2.0-ext\"`}),_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\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A red apple on a white ceramic plate, clean studio product photo\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`recomendado`,children:`Recomendado`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,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:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"grok-imagine-2.0-ext\"`}),_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\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A red apple on a white ceramic plate, clean studio product photo\"`}),_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:` \"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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1:1\"`}),_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:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"quality\"`}),_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:` \"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`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`respuesta-de-envío`,children:`Respuesta de envío`}),`\n`,_jsxs(_components.p,{children:[`Prefiera `,_jsx(_components.code,{children:`X-APIMart-Response-Version: 2026-07-27`}),`. El éxito es HTTP `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`202`})}),`; el id de la tarea es `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`data.id`})}),` (no dependa del legado `,_jsx(_components.code,{children:`data[0].task_id`}),`).`]}),`\n`,_jsx(_components.p,{children:`Conserve:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`data.id`}),` para el sondeo (polling)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`request_id`}),` para depuración en el gateway`]}),`\n`,_jsxs(_components.li,{children:[`el `,_jsx(_components.code,{children:`Idempotency-Key`}),` para reintentos seguros cuando el resultado sea desconocido`]}),`\n`,_jsx(_components.li,{children:`los parámetros originales de la solicitud para UI / soporte`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`idempotencia-y-reintentos-seguros`,children:`Idempotencia y reintentos seguros`}),`\n`,_jsxs(_components.p,{children:[`La generación de imágenes es facturable — se `,_jsx(_components.strong,{children:`recomienda encarecidamente`}),` `,_jsx(_components.code,{children:`Idempotency-Key`}),` (1–191 caracteres ASCII imprimibles; UUID es lo más sencillo; se retiene ~24 horas).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Escenario`}),_jsx(_components.th,{children:`Comportamiento`}),_jsx(_components.th,{children:`Acción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Misma key + mismo body ya completado`}),_jsxs(_components.td,{children:[`Replay; header `,_jsx(_components.code,{children:`Idempotency-Replayed: true`})]}),_jsx(_components.td,{children:`Use el mismo id de tarea`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Misma key aún en curso`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`409 idempotency_in_progress`}),` + `,_jsx(_components.code,{children:`Retry-After`})]}),_jsxs(_components.td,{children:[`Espere y reintente con la `,_jsx(_components.strong,{children:`misma key y el mismo body`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Misma key, body distinto`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`409 idempotency_key_reused`})}),_jsx(_components.td,{children:`Una nueva tarea lógica necesita una key nueva`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Resultado indeterminado`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`409 idempotency_result_indeterminate`})}),_jsx(_components.td,{children:`No cree una key nueva; investigue con la antigua`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`En un timeout de red del POST cuando no pueda saber si el servidor aceptó la tarea, `,_jsx(_components.strong,{children:`no cree de inmediato una key nueva`}),` — reintente con la misma key / body / versión de respuesta.`]}),`\n`,_jsx(Heading,{level:`2`,id:`consultar-tareas`,children:`Consultar tareas`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /v1/tasks/{task_id}?language=en`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer YOUR_API_KEY`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Accept`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`language`}),` opcional: `,_jsx(_components.code,{children:`zh`}),` / `,_jsx(_components.code,{children:`en`}),` / `,_jsx(_components.code,{children:`ko`}),` / `,_jsx(_components.code,{children:`ja`}),` (solo localización de mensajes de error). Vea `,_jsx(_components.a,{href:`/es/api-reference/tasks/status`,children:`Obtener estado de la tarea`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`estados`,children:`Estados`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{style:{textAlign:`center`},children:`Terminal`}),_jsx(_components.th,{children:`Tratamiento`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`pending`}),` / `,_jsx(_components.code,{children:`processing`})]}),_jsx(_components.td,{style:{textAlign:`center`},children:`No`}),_jsxs(_components.td,{children:[`Siga consultando (`,_jsx(_components.code,{children:`result`}),` puede estar ausente — no es un fallo)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completed`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`Sí`}),_jsxs(_components.td,{children:[`Analice `,_jsx(_components.code,{children:`result.images`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failed`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`Sí`}),_jsxs(_components.td,{children:[`Muestre `,_jsx(_components.code,{children:`error.message`}),`; `,_jsx(_components.code,{children:`cost`}),` es `,_jsx(_components.code,{children:`0`}),` (pre-cargo reembolsado)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`No`}),_jsx(_components.td,{children:`Reintentos cortos; si persiste, contacte a soporte con el id de la tarea`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Consulte aproximadamente cada `,_jsx(_components.strong,{children:`2 segundos`}),`; tope cerca de `,_jsx(_components.strong,{children:`10 minutos`}),` o `,_jsx(_components.strong,{children:`120`}),` intentos. Respete `,_jsx(_components.code,{children:`Retry-After`}),` en `,_jsx(_components.code,{children:`429`}),`. Las tareas se conservan ~3 días por defecto — guarde el id de la tarea si el cliente agota el tiempo de espera.`]}),`\n`,_jsx(Heading,{level:`3`,id:`ejemplo-completado`,children:`Ejemplo completado`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`27`,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:`27`,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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"task_01KZQE5CM0Y3KZ6M1N1BK619MX\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_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:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_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:`1786419262`}),_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:` \"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1786419275`}),_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:` \"actual_time\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`13`}),_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:` \"estimated_time\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_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:` \"cost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.08`}),_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:` \"credits_cost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.8`}),_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:` \"result\"`}),_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:` \"images\"`}),_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:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1786505675`}),_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:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/image/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.jpg\"`})}),`\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:` \"image_ids\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"`})}),`\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`,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`,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(Heading,{level:`3`,id:`análisis-de-url-e-image_ids`,children:[`Análisis de `,_jsx(_components.code,{children:`url`}),` e `,_jsx(_components.code,{children:`image_ids`})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`result.images[]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ├─ url[] ← authoritative display/download field (array)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ├─ image_ids[] ← optional opaque IDs`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ expires_at ← Unix seconds; multiply by 1000 for JS Date`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`url[]`}),` para la visualización; cuando `,_jsx(_components.code,{children:`n>1`}),`, recorra todas las entradas`]}),`\n`,_jsxs(_components.li,{children:[`Empareje por índice solo si `,_jsx(_components.code,{children:`image_ids.length === url.length`})]}),`\n`,_jsxs(_components.li,{children:[`Si faltan `,_jsx(_components.code,{children:`image_ids`}),`, la visualización sigue siendo posible`]}),`\n`,_jsxs(_components.li,{children:[`Los enlaces duran `,_jsx(_components.strong,{children:`72 horas`}),` — descargue con prontitud; confíe también en `,_jsx(_components.code,{children:`expires_at`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`facturación`,children:`Facturación`}),`\n`,_jsxs(_components.p,{children:[`Precio base `,_jsx(_components.strong,{children:`$0.08 por imagen`}),` (entregas exitosas):`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`right`},children:_jsx(_components.code,{children:`n`})}),_jsx(_components.th,{style:{textAlign:`right`},children:`Base estimada`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`1`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.08`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`4`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.32`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`8`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.64`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`12`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.96`})]})]})]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`La UI previa al envío debe decir “estimación”; el USD final es `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`data.cost`})})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`data.credits_cost`})}),` es la vista en créditos (actualmente ~ USD × 10)`]}),`\n`,_jsx(_components.li,{children:`Pre-cargo por la cantidad solicitada; liquidación por la cantidad exitosa (reembolsos parciales si hay fallo parcial)`}),`\n`,_jsxs(_components.li,{children:[`Fallo total: `,_jsx(_components.code,{children:`cost=0`}),`, pre-cargo reembolsado`]}),`\n`,_jsxs(_components.li,{children:[`No construya claves de precio a partir de `,_jsx(_components.code,{children:`resolution`}),`; este modelo tiene precio fijo por imagen`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`webhook-opcional`,children:`Webhook (opcional)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,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:`3`,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:` \"webhook\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-service.example.com/apimart\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Proporcione una `,_jsx(_components.strong,{children:`URL base`}),`; la plataforma llama a `,_jsx(_components.code,{children:`{base}/callback`})]}),`\n`,_jsx(_components.li,{children:`Debe ser pública y pasar las comprobaciones SSRF`}),`\n`,_jsxs(_components.li,{children:[`Si se define `,_jsx(_components.code,{children:`webhook_secret`}),`, la firma es `,_jsx(_components.code,{children:`hex(HMAC-SHA256(secret, raw_body))`}),` sobre los bytes en bruto`]}),`\n`,_jsxs(_components.li,{children:[`El cuerpo del callback coincide con el `,_jsx(_components.code,{children:`data`}),` de la consulta de tarea (sin envoltorio extra `,_jsx(_components.code,{children:`{code,data}`}),`)`]}),`\n`,_jsx(_components.li,{children:`Mantenga igualmente un sondeo de baja frecuencia como respaldo`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`errores-comunes`,children:`Errores comunes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`right`},children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error.code`})}),_jsx(_components.th,{children:`Causa`}),_jsx(_components.th,{children:`Acción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_request`})}),_jsx(_components.td,{children:`Prompt vacío / JSON no válido`}),_jsx(_components.td,{children:`Valide la entrada`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_n`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`n`}),` fuera de 1–12`]}),_jsx(_components.td,{children:`Limite la cantidad`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_size`})}),_jsx(_components.td,{children:`Size no está en la lista blanca`}),_jsx(_components.td,{children:`Opciones fijas de selección`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_response_format`})}),_jsxs(_components.td,{children:[`No es `,_jsx(_components.code,{children:`url`})]}),_jsx(_components.td,{children:`Corrija u omita`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_quality`})}),_jsxs(_components.td,{children:[`Se envió el `,_jsx(_components.code,{children:`quality`}),` público`]}),_jsxs(_components.td,{children:[`Use `,_jsx(_components.code,{children:`resolution`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_style`})}),_jsxs(_components.td,{children:[`Se envió `,_jsx(_components.code,{children:`style`})]}),_jsx(_components.td,{children:`Elimine`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_image_input`})}),_jsx(_components.td,{children:`Imágenes de referencia`}),_jsx(_components.td,{children:`Cambie de modelo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_stream`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`stream=true`})}),_jsx(_components.td,{children:`Elimine`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_idempotency_key`})}),_jsx(_components.td,{children:`Key no válida`}),_jsx(_components.td,{children:`Use UUID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`401`}),_jsx(_components.td,{children:`Fallo de autenticación`}),_jsx(_components.td,{children:`Key no válida`}),_jsx(_components.td,{children:`Corrija las credenciales del servidor`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`402`}),_jsx(_components.td,{children:`Pago requerido`}),_jsx(_components.td,{children:`Saldo bajo`}),_jsx(_components.td,{children:`Recargue`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`idempotency_*`})}),_jsx(_components.td,{children:`Conflicto de idempotencia`}),_jsx(_components.td,{children:`Vea la tabla anterior`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`429`}),_jsx(_components.td,{children:`Límite de tasa`}),_jsx(_components.td,{children:`Demasiado rápido`}),_jsxs(_components.td,{children:[`Respete `,_jsx(_components.code,{children:`Retry-After`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`right`},children:`5xx`}),_jsx(_components.td,{children:`Error del servidor`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Conserve el Idempotency-Key; no rote a ciegas`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Prefiera `,_jsx(_components.code,{children:`error.message`}),` en la UI. No exponga detalles internos de autenticación a los usuarios finales.`]}),`\n`,_jsx(Heading,{level:`2`,id:`diferencias-respecto-a-1-5-resumen`,children:`Diferencias respecto a 1.5 (resumen)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Elemento`}),_jsx(_components.th,{children:`Grok Imagine 1.5`}),_jsx(_components.th,{children:`2.0 Ext`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Modelo`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`grok-imagine-1.5-apimart`}),`, etc.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`grok-imagine-2.0-ext`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Imagen a imagen`}),_jsx(_components.td,{children:`Admitido (vea docs 1.5)`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`No admitido`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cantidad`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`1–12`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Campo de calidad`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`resolution`}),` (`,_jsx(_components.code,{children:`quality`}),`); nunca `,_jsx(_components.code,{children:`quality`}),` público`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Salida`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Solo URL`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`TTL de la URL`}),_jsx(_components.td,{children:`Vea docs 1.5 (a menudo 24h)`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`72 horas`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Precio unitario`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`$0.08 / imagen`})})]})]})]})]})}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":"Grok Imagine 2.0 Ext generación de imágenes","description":" - Texto a imagen asíncrono; consulte con task_id\n- 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una)\n- Salida solo en URL; sin imagen a imagen / streaming\n- Las URL de imagen expiran en 72 horas ","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/generation"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,br:`br`,code:`code`,li:`li`,ol:`ol`,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,Note,ParamField,RequestExample,ResponseExample,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Texto a imagen · tareas asíncronas.`}),` Envíe `,_jsx(_components.code,{children:`POST /v1/images/generations`}),` y, a continuación, consulte `,_jsx(_components.a,{href:`/es/api-reference/tasks/status`,children:`Obtener estado de la tarea`}),`.`,_jsx(_components.br,{}),`\n`,`El nombre del modelo es fijo: `,_jsx(_components.code,{children:`grok-imagine-2.0-ext`}),`. `,_jsx(_components.strong,{children:`No admitido`}),`: imágenes de referencia, `,_jsx(_components.code,{children:`stream`}),` ni valores de `,_jsx(_components.code,{children:`response_format`}),` distintos de `,_jsx(_components.code,{children:`url`}),`.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Para trabajar con capas de objetos o editar regiones seleccionadas, consulta `,_jsx(_components.a,{href:`/es/api-reference/images/grok-imagine-2.0-ext/layer-region-edit`,children:`Capas y edición de regiones`}),`.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`No ponga claves de API en bundles del navegador (`,_jsx(_components.code,{children:`VITE_*`}),` / `,_jsx(_components.code,{children:`NEXT_PUBLIC_*`}),`, LocalStorage, etc.). Prefiera llamar a su propio BFF desde el navegador; mantenga la clave de APIMart en el servidor.`]})}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`15`,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:`15`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --request POST \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --url https://api.apimart.ai/v1/images/generations \\\\`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization: Bearer \u003ctoken>'`}),_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\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Content-Type: application/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\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Accept: application/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\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Idempotency-Key: 8eacb46d-ef4e-4f4e-82de-830bd8bc67e2'`}),_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\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'X-APIMart-Response-Version: 2026-07-27'`}),_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\":`#D4D4D4`},children:` --data `}),_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-2.0-ext\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"A red apple on a white ceramic plate, clean studio product photo\",`})}),`\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:` \"size\": \"1:1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution\": \"quality\",`})}),`\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`]})})}),_jsx(CodeBlock,{filename:`Python`,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:` uuid`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`url = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.apimart.ai/v1/images/generations\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`payload = {`})}),`\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-2.0-ext\"`}),_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:`\"A red apple on a white ceramic plate, clean studio product photo\"`}),_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:`: 1,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1: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:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"quality\"`}),_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\"`}),_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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers = {`})}),`\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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer \u003ctoken>\"`}),_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\"`}),_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:` \"Accept\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},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:` \"Idempotency-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: str(uuid.uuid4()),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-APIMart-Response-Version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27\"`}),_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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response = requests.post(url, json=payload, headers=headers)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`print(response.status_code, response.json())`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`28`,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:`28`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` url = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.apimart.ai/v1/images/generations\"`}),_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\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` payload = {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` model: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"grok-imagine-2.0-ext\"`}),_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\":`#D4D4D4`},children:` prompt: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A red apple on a white ceramic plate, clean studio product photo\"`}),_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: 1,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` size: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1:1\"`}),_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\":`#D4D4D4`},children:` resolution: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"quality\"`}),_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\":`#D4D4D4`},children:` response_format: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"url\"`}),_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\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` headers = {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Authorization: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer \u003ctoken>\"`}),_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\"`}),_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\":`#D4D4D4`},children:` Accept: `}),_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:` \"Idempotency-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: crypto.randomUUID(),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-APIMart-Response-Version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-27\"`}),_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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`fetch(url, {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` method: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST\"`}),_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:` headers: headers,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` body: JSON.stringify(payload),`})}),`\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\":`#D4D4D4`},children:` .then(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`async`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (response) => {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` console.log(response.status, `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`((error) => console.error(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Error:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, error));`})]}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`202`,numberOfLines:`12`,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:`12`,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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`202`}),_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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026081111342261665927mpb4IPDb\"`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"task_01KZQE5CM0Y3KZ6M1N1BK619MX\"`}),_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:` \"object\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"generation.task\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"image\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_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:` \"progress\"`}),_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:` \"poll_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX\"`})]}),`\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(CodeBlock,{filename:`400`,numberOfLines:`9`,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:`9`,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:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20260811...\"`}),_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:` \"error\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:'\"`response_format` for grok-imagine-2.0-ext only supports `url` (got: b64_json)\"'}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"invalid_response_format\"`}),_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:` \"param\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"invalid_response_format\"`})]}),`\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(CodeBlock,{filename:`401`,numberOfLines:`7`,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:`7`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`401`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authentication failed. Please check 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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"authentication_error\"`})]}),`\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(CodeBlock,{filename:`402`,numberOfLines:`7`,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:`7`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`402`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Insufficient balance. Please top up and try again\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"payment_required\"`})]}),`\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(CodeBlock,{filename:`429`,numberOfLines:`7`,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:`7`,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:` \"error\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`429`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Too many requests. Please try again later\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"rate_limit_error\"`})]}),`\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`,_jsx(Heading,{level:`2`,id:`capacidades-y-límites`,children:`Capacidades y límites`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Dimensión`}),_jsx(_components.th,{children:`Contrato`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Modelo`}),_jsxs(_components.td,{children:[`Fijo `,_jsx(_components.code,{children:`grok-imagine-2.0-ext`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Capacidad`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Solo texto a imagen`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Modo`}),_jsx(_components.td,{children:`Tarea asíncrona`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Cantidad `,_jsx(_components.code,{children:`n`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1`}),`–`,_jsx(_components.code,{children:`12`}),`, valor predeterminado `,_jsx(_components.code,{children:`1`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`size`})}),_jsx(_components.td,{children:`7 relaciones de aspecto + 5 alias de píxeles (abajo)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Salida`}),_jsxs(_components.td,{children:[`Solo `,_jsx(_components.code,{children:`response_format=url`}),` (también el valor predeterminado)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Calidad`}),_jsxs(_components.td,{children:[`Campo público `,_jsx(_components.code,{children:`resolution`}),`; valor verificado `,_jsx(_components.code,{children:`quality`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No admitido`}),_jsxs(_components.td,{children:[`Imagen a imagen, `,_jsx(_components.code,{children:`stream=true`}),`, `,_jsx(_components.code,{children:`quality`}),` público, `,_jsx(_components.code,{children:`style`}),`, `,_jsx(_components.code,{children:`b64_json`}),` / `,_jsx(_components.code,{children:`base64`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Facturación`}),_jsxs(_components.td,{children:[`Precio unitario fijo; se cobra por imágenes `,_jsx(_components.strong,{children:`entregadas con éxito`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`autenticación-y-headers-recomendados`,children:`Autenticación y headers recomendados`}),`\n`,_jsxs(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:[_jsxs(_components.p,{children:[`Token Bearer. Obtenga una clave en la `,_jsx(_components.a,{href:`https://apimart.ai/keys`,children:`página de API Key`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Bearer YOUR_API_KEY`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Notas`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`application/json`}),` (envío)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Accept`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Idempotency-Key`})}),_jsxs(_components.td,{children:[`Muy recomendado. Nuevo UUID por generación confirmada por el usuario; los reintentos de red `,_jsx(_components.strong,{children:`deben reutilizar`}),` la misma key y el mismo body`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-APIMart-Response-Version`})}),_jsxs(_components.td,{children:[`Prefiera `,_jsx(_components.code,{children:`2026-07-27`}),` para una forma de envío estable (`,_jsx(_components.code,{children:`data.id`}),`)`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`parámetros-de-la-solicitud`,children:`Parámetros de la solicitud`}),`\n`,_jsx(ParamField,{body:`model`,type:`string`,required:true,id:`param-model`,children:_jsxs(_components.p,{children:[`Valor fijo: `,_jsx(_components.code,{children:`grok-imagine-2.0-ext`})]})}),`\n`,_jsxs(ParamField,{body:`nsfw_check`,type:`boolean`,default:`false`,id:`param-nsfw-check`,children:[_jsx(_components.p,{children:`Indica si se debe moderar el contenido antes de enviar la tarea de imagen.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`true`}),`: revisar los prompts y las imágenes de entrada con `,_jsx(_components.code,{children:`omni-moderation-latest`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`false`}),` u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)`]}),`\n`]})]}),`\n`,_jsx(ParamField,{body:`prompt`,type:`string`,required:true,id:`param-prompt`,children:_jsx(_components.p,{children:`Prompt. Debe ser no vacío tras el trim. Haga trim antes de enviar.`})}),`\n`,_jsx(ParamField,{body:`n`,type:`integer`,default:`1`,id:`param-n`,children:_jsxs(_components.p,{children:[`Cantidad de imágenes: `,_jsx(_components.code,{children:`1`}),`–`,_jsx(_components.code,{children:`12`}),`. Un `,_jsx(_components.code,{children:`0`}),` explícito produce error. Omítalo para `,_jsx(_components.code,{children:`1`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`size`,type:`string`,id:`param-size`,children:[_jsxs(_components.p,{children:[`Relación de aspecto. `,_jsx(_components.strong,{children:`Prefiera cadenas de proporción`}),` (la UI solo debe mostrar proporciones):`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`size`})}),_jsx(_components.th,{children:`Orientación`}),_jsx(_components.th,{children:`Uso típico`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1:1`})}),_jsx(_components.td,{children:`Cuadrado`}),_jsx(_components.td,{children:`Producto, avatar`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2:3`})}),_jsx(_components.td,{children:`Vertical`}),_jsx(_components.td,{children:`Póster, cuerpo entero`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3:2`})}),_jsx(_components.td,{children:`Horizontal`}),_jsx(_components.td,{children:`Foto, escena amplia`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3:4`})}),_jsx(_components.td,{children:`Vertical`}),_jsx(_components.td,{children:`Comercio electrónico, personas`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`4:3`})}),_jsx(_components.td,{children:`Horizontal`}),_jsx(_components.td,{children:`Arte de visualización`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`9:16`})}),_jsx(_components.td,{children:`Vertical`}),_jsx(_components.td,{children:`Portada de Story / video corto`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`16:9`})}),_jsx(_components.td,{children:`Ancho`}),_jsx(_components.td,{children:`Banner, portada de video`})]})]})]}),_jsxs(_components.p,{children:[`Alias de píxeles: `,_jsx(_components.code,{children:`1024x1024`}),` (1:1), `,_jsx(_components.code,{children:`1024x1792`}),` (2:3), `,_jsx(_components.code,{children:`1792x1024`}),` (3:2), `,_jsx(_components.code,{children:`720x1280`}),` (9:16), `,_jsx(_components.code,{children:`1280x720`}),` (16:9).`]}),_jsxs(_components.p,{children:[`Los valores fuera de la lista blanca devuelven `,_jsx(_components.code,{children:`400 invalid_size`}),` (p. ej. `,_jsx(_components.code,{children:`1:2`}),`, `,_jsx(_components.code,{children:`2:1`}),`, `,_jsx(_components.code,{children:`4:5`}),`, `,_jsx(_components.code,{children:`auto`}),`).`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Los píxeles reales de una proporción pueden diferir de la tabla de alias (p. ej. `,_jsx(_components.code,{children:`1:1`}),` puede devolver 1408×1408). Confíe en la imagen devuelta; no reescriba `,_jsx(_components.code,{children:`size`}),` a partir de los píxeles medidos.`]})})]}),`\n`,_jsxs(ParamField,{body:`resolution`,type:`string`,id:`param-resolution`,children:[_jsxs(_components.p,{children:[`Campo de modo de calidad. Valor verificado: `,_jsx(_components.code,{children:`quality`}),`.`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Omítalo (el modelo es modo calidad por defecto), o`}),`\n`,_jsxs(_components.li,{children:[`Pase `,_jsx(_components.code,{children:`resolution: \"quality\"`}),` de forma explícita`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`No`}),` es un nivel de píxeles `,_jsx(_components.code,{children:`1K`}),` / `,_jsx(_components.code,{children:`2K`}),` / `,_jsx(_components.code,{children:`4K`}),`; el encuadre lo controla `,_jsx(_components.code,{children:`size`}),`.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`No envíe el campo público `,_jsx(_components.code,{children:`quality`}),` — recibirá `,_jsx(_components.code,{children:`400 invalid_quality`}),`. Use `,_jsx(_components.code,{children:`resolution`}),`.`]})})]}),`\n`,_jsx(ParamField,{body:`response_format`,type:`string`,default:`url`,id:`param-response-format`,children:_jsxs(_components.p,{children:[`Solo se permite `,_jsx(_components.code,{children:`url`}),`. Puede omitirse. `,_jsx(_components.code,{children:`b64_json`}),` / `,_jsx(_components.code,{children:`base64`}),` → `,_jsx(_components.code,{children:`400 invalid_response_format`}),`.`]})}),`\n`,_jsx(ParamField,{body:`webhook`,type:`string`,id:`param-webhook`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`URL base`}),` HTTPS pública opcional. En estado terminal, la plataforma hace POST a `,_jsx(_components.code,{children:`{webhook}/callback`}),`. Solo en el servidor — vea `,_jsx(_components.a,{href:`#webhook-opcional`,children:`Webhook`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`parámetros-no-admitidos`,children:`Parámetros no admitidos`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parámetro`}),_jsx(_components.th,{children:`Comportamiento`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quality`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`400 invalid_quality`}),` → use `,_jsx(_components.code,{children:`resolution`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`style`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_style`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`image_urls`}),` / `,_jsx(_components.code,{children:`image_with_roles`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_image_input`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stream: true`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_stream`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`response_format: \"b64_json\"`}),` / `,_jsx(_components.code,{children:`\"base64\"`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_response_format`})})]})]})]}),`\n`,_jsx(_components.p,{children:`Construya las solicitudes con una lista blanca; no reenvíe un objeto de formulario genérico de otros modelos de imagen.`}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplos-de-solicitud`,children:`Ejemplos de solicitud`}),`\n`,_jsx(Heading,{level:`3`,id:`mínimo`,children:`Mínimo`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,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:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"grok-imagine-2.0-ext\"`}),_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\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A red apple on a white ceramic plate, clean studio product photo\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`recomendado`,children:`Recomendado`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,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:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"grok-imagine-2.0-ext\"`}),_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\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A red apple on a white ceramic plate, clean studio product photo\"`}),_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:` \"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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1:1\"`}),_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:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"quality\"`}),_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:` \"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`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`respuesta-de-envío`,children:`Respuesta de envío`}),`\n`,_jsxs(_components.p,{children:[`Prefiera `,_jsx(_components.code,{children:`X-APIMart-Response-Version: 2026-07-27`}),`. El éxito es HTTP `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`202`})}),`; el id de la tarea es `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`data.id`})}),` (no dependa del legado `,_jsx(_components.code,{children:`data[0].task_id`}),`).`]}),`\n`,_jsx(_components.p,{children:`Conserve:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`data.id`}),` para el sondeo (polling)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`request_id`}),` para depuración en el gateway`]}),`\n`,_jsxs(_components.li,{children:[`el `,_jsx(_components.code,{children:`Idempotency-Key`}),` para reintentos seguros cuando el resultado sea desconocido`]}),`\n`,_jsx(_components.li,{children:`los parámetros originales de la solicitud para UI / soporte`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`idempotencia-y-reintentos-seguros`,children:`Idempotencia y reintentos seguros`}),`\n`,_jsxs(_components.p,{children:[`La generación de imágenes es facturable — se `,_jsx(_components.strong,{children:`recomienda encarecidamente`}),` `,_jsx(_components.code,{children:`Idempotency-Key`}),` (1–191 caracteres ASCII imprimibles; UUID es lo más sencillo; se retiene ~24 horas).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Escenario`}),_jsx(_components.th,{children:`Comportamiento`}),_jsx(_components.th,{children:`Acción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Misma key + mismo body ya completado`}),_jsxs(_components.td,{children:[`Replay; header `,_jsx(_components.code,{children:`Idempotency-Replayed: true`})]}),_jsx(_components.td,{children:`Use el mismo id de tarea`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Misma key aún en curso`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`409 idempotency_in_progress`}),` + `,_jsx(_components.code,{children:`Retry-After`})]}),_jsxs(_components.td,{children:[`Espere y reintente con la `,_jsx(_components.strong,{children:`misma key y el mismo body`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Misma key, body distinto`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`409 idempotency_key_reused`})}),_jsx(_components.td,{children:`Una nueva tarea lógica necesita una key nueva`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Resultado indeterminado`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`409 idempotency_result_indeterminate`})}),_jsx(_components.td,{children:`No cree una key nueva; investigue con la antigua`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`En un timeout de red del POST cuando no pueda saber si el servidor aceptó la tarea, `,_jsx(_components.strong,{children:`no cree de inmediato una key nueva`}),` — reintente con la misma key / body / versión de respuesta.`]}),`\n`,_jsx(Heading,{level:`2`,id:`consultar-tareas`,children:`Consultar tareas`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /v1/tasks/{task_id}?language=en`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer YOUR_API_KEY`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Accept`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`language`}),` opcional: `,_jsx(_components.code,{children:`zh`}),` / `,_jsx(_components.code,{children:`en`}),` / `,_jsx(_components.code,{children:`ko`}),` / `,_jsx(_components.code,{children:`ja`}),` (solo localización de mensajes de error). Vea `,_jsx(_components.a,{href:`/es/api-reference/tasks/status`,children:`Obtener estado de la tarea`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`estados`,children:`Estados`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{style:{textAlign:`center`},children:`Terminal`}),_jsx(_components.th,{children:`Tratamiento`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`pending`}),` / `,_jsx(_components.code,{children:`processing`})]}),_jsx(_components.td,{style:{textAlign:`center`},children:`No`}),_jsxs(_components.td,{children:[`Siga consultando (`,_jsx(_components.code,{children:`result`}),` puede estar ausente — no es un fallo)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completed`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`Sí`}),_jsxs(_components.td,{children:[`Analice `,_jsx(_components.code,{children:`result.images`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failed`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`Sí`}),_jsxs(_components.td,{children:[`Muestre `,_jsx(_components.code,{children:`error.message`}),`; `,_jsx(_components.code,{children:`cost`}),` es `,_jsx(_components.code,{children:`0`}),` (pre-cargo reembolsado)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`No`}),_jsx(_components.td,{children:`Reintentos cortos; si persiste, contacte a soporte con el id de la tarea`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Consulte aproximadamente cada `,_jsx(_components.strong,{children:`2 segundos`}),`; tope cerca de `,_jsx(_components.strong,{children:`10 minutos`}),` o `,_jsx(_components.strong,{children:`120`}),` intentos. Respete `,_jsx(_components.code,{children:`Retry-After`}),` en `,_jsx(_components.code,{children:`429`}),`. Las tareas se conservan ~3 días por defecto — guarde el id de la tarea si el cliente agota el tiempo de espera.`]}),`\n`,_jsx(Heading,{level:`3`,id:`ejemplo-completado`,children:`Ejemplo completado`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`27`,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:`27`,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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"task_01KZQE5CM0Y3KZ6M1N1BK619MX\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_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:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_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:`1786419262`}),_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:` \"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1786419275`}),_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:` \"actual_time\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`13`}),_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:` \"estimated_time\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_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:` \"cost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.08`}),_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:` \"credits_cost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.8`}),_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:` \"result\"`}),_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:` \"images\"`}),_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:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1786505675`}),_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:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com/image/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.jpg\"`})}),`\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:` \"image_ids\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"`})}),`\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`,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`,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(Heading,{level:`3`,id:`análisis-de-url-e-image_ids`,children:[`Análisis de `,_jsx(_components.code,{children:`url`}),` e `,_jsx(_components.code,{children:`image_ids`})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`result.images[]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ├─ url[] ← authoritative display/download field (array)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ├─ image_ids[] ← optional opaque IDs`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` └─ expires_at ← Unix seconds; multiply by 1000 for JS Date`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`url[]`}),` para la visualización; cuando `,_jsx(_components.code,{children:`n>1`}),`, recorra todas las entradas`]}),`\n`,_jsxs(_components.li,{children:[`Empareje por índice solo si `,_jsx(_components.code,{children:`image_ids.length === url.length`})]}),`\n`,_jsxs(_components.li,{children:[`Si faltan `,_jsx(_components.code,{children:`image_ids`}),`, la visualización sigue siendo posible`]}),`\n`,_jsxs(_components.li,{children:[`Los enlaces duran `,_jsx(_components.strong,{children:`72 horas`}),` — descargue con prontitud; confíe también en `,_jsx(_components.code,{children:`expires_at`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`facturación`,children:`Facturación`}),`\n`,_jsxs(_components.p,{children:[`Precio base `,_jsx(_components.strong,{children:`$0.08 por imagen`}),` (entregas exitosas):`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`right`},children:_jsx(_components.code,{children:`n`})}),_jsx(_components.th,{style:{textAlign:`right`},children:`Base estimada`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`1`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.08`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`4`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.32`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`8`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.64`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`12`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`$0.96`})]})]})]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`La UI previa al envío debe decir “estimación”; el USD final es `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`data.cost`})})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`data.credits_cost`})}),` es la vista en créditos (actualmente ~ USD × 10)`]}),`\n`,_jsx(_components.li,{children:`Pre-cargo por la cantidad solicitada; liquidación por la cantidad exitosa (reembolsos parciales si hay fallo parcial)`}),`\n`,_jsxs(_components.li,{children:[`Fallo total: `,_jsx(_components.code,{children:`cost=0`}),`, pre-cargo reembolsado`]}),`\n`,_jsxs(_components.li,{children:[`No construya claves de precio a partir de `,_jsx(_components.code,{children:`resolution`}),`; este modelo tiene precio fijo por imagen`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`webhook-opcional`,children:`Webhook (opcional)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,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:`3`,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:` \"webhook\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://your-service.example.com/apimart\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Proporcione una `,_jsx(_components.strong,{children:`URL base`}),`; la plataforma llama a `,_jsx(_components.code,{children:`{base}/callback`})]}),`\n`,_jsx(_components.li,{children:`Debe ser pública y pasar las comprobaciones SSRF`}),`\n`,_jsxs(_components.li,{children:[`Si se define `,_jsx(_components.code,{children:`webhook_secret`}),`, la firma es `,_jsx(_components.code,{children:`hex(HMAC-SHA256(secret, raw_body))`}),` sobre los bytes en bruto`]}),`\n`,_jsxs(_components.li,{children:[`El cuerpo del callback coincide con el `,_jsx(_components.code,{children:`data`}),` de la consulta de tarea (sin envoltorio extra `,_jsx(_components.code,{children:`{code,data}`}),`)`]}),`\n`,_jsx(_components.li,{children:`Mantenga igualmente un sondeo de baja frecuencia como respaldo`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`errores-comunes`,children:`Errores comunes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`right`},children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error.code`})}),_jsx(_components.th,{children:`Causa`}),_jsx(_components.th,{children:`Acción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_request`})}),_jsx(_components.td,{children:`Prompt vacío / JSON no válido`}),_jsx(_components.td,{children:`Valide la entrada`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_n`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`n`}),` fuera de 1–12`]}),_jsx(_components.td,{children:`Limite la cantidad`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_size`})}),_jsx(_components.td,{children:`Size no está en la lista blanca`}),_jsx(_components.td,{children:`Opciones fijas de selección`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_response_format`})}),_jsxs(_components.td,{children:[`No es `,_jsx(_components.code,{children:`url`})]}),_jsx(_components.td,{children:`Corrija u omita`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_quality`})}),_jsxs(_components.td,{children:[`Se envió el `,_jsx(_components.code,{children:`quality`}),` público`]}),_jsxs(_components.td,{children:[`Use `,_jsx(_components.code,{children:`resolution`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_style`})}),_jsxs(_components.td,{children:[`Se envió `,_jsx(_components.code,{children:`style`})]}),_jsx(_components.td,{children:`Elimine`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_image_input`})}),_jsx(_components.td,{children:`Imágenes de referencia`}),_jsx(_components.td,{children:`Cambie de modelo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_stream`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`stream=true`})}),_jsx(_components.td,{children:`Elimine`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_idempotency_key`})}),_jsx(_components.td,{children:`Key no válida`}),_jsx(_components.td,{children:`Use UUID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`401`}),_jsx(_components.td,{children:`Fallo de autenticación`}),_jsx(_components.td,{children:`Key no válida`}),_jsx(_components.td,{children:`Corrija las credenciales del servidor`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`402`}),_jsx(_components.td,{children:`Pago requerido`}),_jsx(_components.td,{children:`Saldo bajo`}),_jsx(_components.td,{children:`Recargue`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`idempotency_*`})}),_jsx(_components.td,{children:`Conflicto de idempotencia`}),_jsx(_components.td,{children:`Vea la tabla anterior`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`429`}),_jsx(_components.td,{children:`Límite de tasa`}),_jsx(_components.td,{children:`Demasiado rápido`}),_jsxs(_components.td,{children:[`Respete `,_jsx(_components.code,{children:`Retry-After`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`right`},children:`5xx`}),_jsx(_components.td,{children:`Error del servidor`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Conserve el Idempotency-Key; no rote a ciegas`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Prefiera `,_jsx(_components.code,{children:`error.message`}),` en la UI. No exponga detalles internos de autenticación a los usuarios finales.`]}),`\n`,_jsx(Heading,{level:`2`,id:`diferencias-respecto-a-1-5-resumen`,children:`Diferencias respecto a 1.5 (resumen)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Elemento`}),_jsx(_components.th,{children:`Grok Imagine 1.5`}),_jsx(_components.th,{children:`2.0 Ext`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Modelo`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`grok-imagine-1.5-apimart`}),`, etc.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`grok-imagine-2.0-ext`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Imagen a imagen`}),_jsx(_components.td,{children:`Admitido (vea docs 1.5)`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`No admitido`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cantidad`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`1–12`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Campo de calidad`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`resolution`}),` (`,_jsx(_components.code,{children:`quality`}),`); nunca `,_jsx(_components.code,{children:`quality`}),` público`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Salida`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Solo URL`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`TTL de la URL`}),_jsx(_components.td,{children:`Vea docs 1.5 (a menudo 24h)`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`72 horas`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Precio unitario`}),_jsx(_components.td,{children:`Vea docs 1.5`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`$0.08 / imagen`})})]})]})]})]})}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":"Grok Imagine 2.0 Ext generación de imágenes","description":" - Texto a imagen asíncrono; consulte con task_id\n- 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una)\n- Salida solo en URL; sin imagen a imagen / streaming\n- Las URL de imagen expiran en 72 horas ","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/generation"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Capacidades y límites","slug":"capacidades-y-límites","depth":2,"children":[]},{"title":"Autenticación y headers recomendados","slug":"autenticación-y-headers-recomendados","depth":2,"children":[]},{"title":"Parámetros de la solicitud","slug":"parámetros-de-la-solicitud","depth":2,"children":[{"title":"Parámetros no admitidos","slug":"parámetros-no-admitidos","depth":3,"children":[]}]},{"title":"Ejemplos de solicitud","slug":"ejemplos-de-solicitud","depth":2,"children":[{"title":"Mínimo","slug":"mínimo","depth":3,"children":[]},{"title":"Recomendado","slug":"recomendado","depth":3,"children":[]}]},{"title":"Respuesta de envío","slug":"respuesta-de-envío","depth":2,"children":[]},{"title":"Idempotencia y reintentos seguros","slug":"idempotencia-y-reintentos-seguros","depth":2,"children":[]},{"title":"Consultar tareas","slug":"consultar-tareas","depth":2,"children":[{"title":"Estados","slug":"estados","depth":3,"children":[]},{"title":"Ejemplo completado","slug":"ejemplo-completado","depth":3,"children":[]},{"title":"Análisis de url e image_ids","slug":"análisis-de-url-e-image_ids","depth":3,"children":[]}]},{"title":"Facturación","slug":"facturación","depth":2,"children":[]},{"title":"Webhook (opcional)","slug":"webhook-opcional","depth":2,"children":[]},{"title":"Errores comunes","slug":"errores-comunes","depth":2,"children":[]},{"title":"Diferencias respecto a 1.5 (resumen)","slug":"diferencias-respecto-a-1-5-resumen","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"15\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --request POST \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --url https://api.apimart.ai/v1/images/generations \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Authorization: Bearer \u0026#x3C;token>'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Content-Type: application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Accept: application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'Idempotency-Key: 8eacb46d-ef4e-4f4e-82de-830bd8bc67e2'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --header \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'X-APIMart-Response-Version: 2026-07-27'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> --data \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"model\": \"grok-imagine-2.0-ext\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"prompt\": \"A red apple on a white ceramic plate, clean studio product photo\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"n\": 1,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"size\": \"1:1\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"resolution\": \"quality\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"response_format\": \"url\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"25\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> uuid\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">url = \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.apimart.ai/v1/images/generations\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">payload = {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"grok-imagine-2.0-ext\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"prompt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"A red apple on a white ceramic plate, clean studio product photo\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"n\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: 1,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"size\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1:1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"resolution\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"quality\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"response_format\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">headers = {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Bearer \u0026#x3C;token>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Accept\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Idempotency-Key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: str(uuid.uuid4()),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"X-APIMart-Response-Version\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-07-27\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response = requests.post(url, json=payload, headers=headers)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">print(response.status_code, response.json())\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"28\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> url = \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.apimart.ai/v1/images/generations\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> payload = {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> model: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"grok-imagine-2.0-ext\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> prompt: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"A red apple on a white ceramic plate, clean studio product photo\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> n: 1,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> size: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1:1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> resolution: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"quality\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response_format: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">};\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> headers = {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> Authorization: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Bearer \u0026#x3C;token>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> Accept: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"application/json\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Idempotency-Key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: crypto.randomUUID(),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"X-APIMart-Response-Version\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-07-27\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">};\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">fetch(url, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> method: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"POST\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> headers: headers,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> body: JSON.stringify(payload),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">})\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> .then(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">async\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (response) => {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> console.log(response.status, \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json());\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> })\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> .\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">catch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">((error) => console.error(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Error:\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, error));\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"202","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">202\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026081111342261665927mpb4IPDb\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"task_01KZQE5CM0Y3KZ6M1N1BK619MX\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"object\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"generation.task\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"image\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"pending\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"progress\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"poll_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"20260811...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"`response_format` for grok-imagine-2.0-ext only supports `url` (got: b64_json)\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"invalid_response_format\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"param\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"invalid_response_format\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"401","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">401\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Authentication failed. Please check your API key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"authentication_error\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"402","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">402\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Insufficient balance. Please top up and try again\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"payment_required\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"429","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">429\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Too many requests. Please try again later\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"rate_limit_error\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Grok Imagine 2.0 Ext generación de imágenes","path":"/v1/images/generations","servers":[{"url":"https://api.apimart.ai"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"Authorization":{"schema":[{"type":"string","description":"Token Bearer. Obtenga una clave en la página de API Key .","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"model":[{"type":"string","description":"Valor fijo: `grok-imagine-2.0-ext`","required":true}],"nsfw_check":[{"type":"boolean","description":"Indica si se debe moderar el contenido antes de enviar la tarea de imagen. `true` : revisar los prompts y las imágenes de entrada con `omni-moderation-latest` `false` u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)"}],"prompt":[{"type":"string","description":"Prompt. Debe ser no vacío tras el trim. Haga trim antes de enviar.","required":true}],"n":[{"type":"integer","description":"Cantidad de imágenes: `1` – `12` . Un `0` explícito produce error. Omítalo para `1` ."}],"size":[{"type":"string","description":"Relación de aspecto. Prefiera cadenas de proporción (la UI solo debe mostrar proporciones): `size` Orientación Uso típico `1:1` Cuadrado Producto, avatar `2:3` Vertical Póster, cuerpo entero `3:2` Horizontal Foto, escena amplia `3:4` Vertical Comercio electrónico, personas `4:3` Horizontal Arte de visualización `9:16` Vertical Portada de Story / video corto `16:9` Ancho Banner, portada de video Alias de píxeles: `1024x1024` (1:1), `1024x1792` (2:3), `1792x1024` (3:2), `720x1280` (9:16), `1280x720` (16:9). Los valores fuera de la lista blanca devuelven `400 invalid_size` (p. ej. `1:2` , `2:1` , `4:5` , `auto` )."}],"resolution":[{"type":"string","description":"Campo de modo de calidad. Valor verificado: `quality` . Omítalo (el modelo es modo calidad por defecto), o Pase `resolution: \"quality\"` de forma explícita No es un nivel de píxeles `1K` / `2K` / `4K` ; el encuadre lo controla `size` ."}],"response_format":[{"type":"string","description":"Solo se permite `url` . Puede omitirse. `b64_json` / `base64` → `400 invalid_response_format` ."}],"webhook":[{"type":"string","description":"URL base HTTPS pública opcional. En estado terminal, la plataforma hace POST a `{webhook}/callback` . Solo en el servidor — vea Webhook ."}]}}],"examples":{"example":{"value":{"model":"\u003cstring>","nsfw_check":true,"prompt":"\u003cstring>","n":123,"size":"\u003cstring>","resolution":"\u003cstring>","response_format":"\u003cstring>","webhook":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":["/_mintlify/custom/apicore/1f7e29c94a916812/cn-domain-rewrite.js","/_mintlify/custom/apicore/afc6076845564106/param-field-copy.js"],"subdomain":"apicore","siteName":"APIMart","title":"Grok Imagine 2.0 Ext generación de imágenes - APIMart","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"zh-Hans":{"href":"/cn/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"ja":{"href":"/ja/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"ko":{"href":"/ko/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"ru":{"href":"/ru/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"de":{"href":"/de/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"fr":{"href":"/fr/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"pt":{"href":"/pt/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"id":{"href":"/id/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":1},"es":{"href":"/es/api-reference/images/grok-imagine-2.0-ext/generation","matchLevel":0}}},"lastModified":"2026-08-19T07:49:50.726Z","originalFileLocation":"es/api-reference/images/grok-imagine-2.0-ext/generation.mdx","locale":"es"},"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=\"- Texto a imagen asíncrono; consulte con task_id - 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una) - Salida solo en URL; sin imagen a imagen / streaming - Las URL de imagen expiran en 72 horas\">\u003cmeta data-mint-head name=\"keywords\" content=\"OpenAI compatible, API gateway, GPT-5, Claude, Gemini, multi-provider, transparent pricing, SLA\">\u003cmeta data-mint-head name=\"application-name\" content=\"APIMart\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_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/apicore/lN2mX6cSovqJeXFa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Grok Imagine 2.0 Ext generación de imágenes - APIMart\">\u003cmeta data-mint-head property=\"og:description\" content=\"- Texto a imagen asíncrono; consulte con task_id - 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una) - Salida solo en URL; sin imagen a imagen / streaming - Las URL de imagen expiran en 72 horas\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"APIMart\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apicore.mintlify.site/_mintlify/api/og/v2?division=Grok+Imagine+2.0+Ext\u0026amp;title=Grok+Imagine+2.0+Ext+generaci%C3%B3n+de+im%C3%A1genes\u0026amp;description=+-+Texto+a+imagen+as%C3%ADncrono%3B+consulte+con+task_id%0A-+1%E2%80%9312+im%C3%A1genes+por+solicitud%3B+cobro+por+imagen+entregada+con+%C3%A9xito+%28%240.08+cada+una%29%0A-+Salida+solo+en+URL%3B+sin\u0026amp;theme=20cab0b8d8d3e93733d26c49\u0026amp;signature=33200d4f07732b9eaefb894f056aed77ea790eb87ae585410b7d3109d4a650d7\">\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=\"Grok Imagine 2.0 Ext generación de imágenes - APIMart\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"- Texto a imagen asíncrono; consulte con task_id - 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una) - Salida solo en URL; sin imagen a imagen / streaming - Las URL de imagen expiran en 72 horas\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apicore.mintlify.site/_mintlify/api/og/v2?division=Grok+Imagine+2.0+Ext\u0026amp;title=Grok+Imagine+2.0+Ext+generaci%C3%B3n+de+im%C3%A1genes\u0026amp;description=+-+Texto+a+imagen+as%C3%ADncrono%3B+consulte+con+task_id%0A-+1%E2%80%9312+im%C3%A1genes+por+solicitud%3B+cobro+por+imagen+entregada+con+%C3%A9xito+%28%240.08+cada+una%29%0A-+Salida+solo+en+URL%3B+sin\u0026amp;theme=20cab0b8d8d3e93733d26c49\u0026amp;signature=33200d4f07732b9eaefb894f056aed77ea790eb87ae585410b7d3109d4a650d7\">\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/apicore/lN2mX6cSovqJeXFa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"APIMart\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@APIMart_\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/images/grok-imagine-2.0-ext/generation.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.apimart.ai/en/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hans\" href=\"https://docs.apimart.ai/cn/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.apimart.ai/ja/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.apimart.ai/ko/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.apimart.ai/ru/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.apimart.ai/de/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.apimart.ai/fr/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.apimart.ai/pt/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.apimart.ai/id/api-reference/images/grok-imagine-2.0-ext/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.apimart.ai/en/api-reference/images/grok-imagine-2.0-ext/generation\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apimart.ai/#organization\",\"name\":\"APIMart\",\"url\":\"https://docs.apimart.ai\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apimart.ai#website\",\"name\":\"APIMart\",\"url\":\"https://docs.apimart.ai\",\"publisher\":{\"@id\":\"https://docs.apimart.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation#webpage\",\"url\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation\",\"name\":\"Grok Imagine 2.0 Ext generación de imágenes\",\"description\":\"- Texto a imagen asíncrono; consulte con task_id - 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una) - Salida solo en URL; sin imagen a imagen / streaming - Las URL de imagen expiran en 72 horas\",\"dateModified\":\"2026-08-19T07:49:50.726Z\",\"isPartOf\":{\"@id\":\"https://docs.apimart.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Serie de imágenes\",\"item\":\"https://docs.apimart.ai/es/api-reference/images/gemini-nano-banana-2.1/generation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Grok Imagine 2.0 Ext generación de imágenes\",\"item\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation#apireference\",\"headline\":\"Grok Imagine 2.0 Ext generación de imágenes\",\"name\":\"Grok Imagine 2.0 Ext generación de imágenes\",\"description\":\"- Texto a imagen asíncrono; consulte con task_id - 1–12 imágenes por solicitud; cobro por imagen entregada con éxito ($0.08 cada una) - Salida solo en URL; sin imagen a imagen / streaming - Las URL de imagen expiran en 72 horas\",\"url\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apimart.ai/es/api-reference/images/grok-imagine-2.0-ext/generation#webpage\"},\"dateModified\":\"2026-08-19T07:49:50.726Z\",\"publisher\":{\"@id\":\"https://docs.apimart.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apimart.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"APIMart\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"APIMart","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/en/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"zh-Hans","pages":[{"title":"zh-Hans","href":"/cn/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"id","pages":[{"title":"id","href":"/id/api-reference/images/grok-imagine-2.0-ext/generation"}]},{"language":"es","tabs":[{"tab":"Manual de la API","groups":[{"group":"Visión general","pages":[{"title":"APIMart — Gateway de API compatible con OpenAI (GPT-5, Claude, Gemini)","href":"/es"}]},{"group":"Modelos","pages":[{"title":"API de metadatos de la lista de modelos","api":"GET https://api.apimart.ai/v1/models","href":"/es/api-reference/texts/models/list"}]},{"group":"Serie de texto","icon":"text","pages":[{"title":"API general de Chat (streaming por defecto)","api":"POST https://api.apimart.ai/v1/chat/completions","href":"/es/api-reference/texts/general/chat-completions"},{"title":"API general de Chat (sin streaming por defecto)","api":"POST https://api.apimart.ai/api/v1/chat/completions","href":"/es/api-reference/texts/general/chat-completions-nostream"},{"title":"API de Mensajes Claude","api":"POST https://api.apimart.ai/v1/messages","href":"/es/api-reference/texts/general/claude-messages"},{"title":"Formato nativo de Gemini","api":"POST https://api.apimart.ai/v1beta/models/{model}:{method}","href":"/es/api-reference/texts/gemini/quickstart"},{"title":"API multimodal OpenAI Responses","api":"POST https://api.apimart.ai/v1/responses","href":"/es/api-reference/texts/openai/responses"},{"title":"Guía de caché de contexto de OpenAI","sidebarTitle":"Caché de contexto de OpenAI","icon":"database","href":"/es/api-reference/texts/openai/context-cache"},{"title":"Guía de uso de la caché de contexto de Gemini","sidebarTitle":"Caché de contexto de Gemini","icon":"database","href":"/es/api-reference/texts/gemini/context-cache"},{"title":"Guía de uso de la caché de contexto de Claude","sidebarTitle":"Caché de contexto de Claude","icon":"database","href":"/es/api-reference/texts/general/claude-context-cache"},{"group":"qwen3.8-max","icon":"message","pages":[{"title":"qwen3.8-max Integration Guide","api":"POST https://api.apimart.ai/v1/chat/completions","href":"/es/api-reference/texts/qwen3.8-max/guide"},{"title":"Model Pricing API","api":"GET https://api.apimart.ai/api/pricing/model?model=qwen3.8-max","href":"/es/api-reference/texts/qwen3.8-max/pricing"}]}]},{"group":"Serie de imágenes","icon":"image","pages":[{"group":"Nano banana 2.1","icon":"image","pages":[{"title":"Nano banana 2.1 Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-nano-banana-2.1/generation"}]},{"group":"Nano banana2","icon":"image","pages":[{"title":"Nano banana2 Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-3.1-flash/generation"},{"title":"Nano Banana Lite Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-3.1-flash/generation-lite"}]},{"group":"Nano banana Pro","icon":"image","pages":[{"title":"Nano banana Pro Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-3-pro/generation"}]},{"group":"Nano banana","icon":"image","pages":[{"title":"Nano banana Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gemini-2.5-flash/generation"}]},{"group":"Imagen-4.0","icon":"image","pages":[{"title":"Generación de imágenes con Imagen 4.0 Apimart","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/imagen-4.0-apimart/generation"}]},{"group":"GPT-Image(1/1.5)","icon":"image","pages":[{"title":"Generación de imágenes con GPT-Image(1/1.5)","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-1/generation"}]},{"group":"GPT-Image-2","icon":"image","pages":[{"title":"Generación de imágenes con GPT-Image-2","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2/generation"},{"title":"Generación de imágenes con GPT-Image-2 canal oficial","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2/official"}]},{"group":"GPT-Image-2.5","icon":"image","pages":[{"title":"Generación de imágenes GPT-Image-2.5","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2.5/generation"}]},{"group":"GPT-Image-2.5 Ext","icon":"image","pages":[{"title":"GPT-Image-2.5 Ext — Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2.5-ext/generation"}]},{"group":"GPT-Image-2.6","icon":"image","pages":[{"title":"GPT-Image-2.6 Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2.6/generation"}]},{"group":"GPT-Image-2.6 Ext","icon":"image","pages":[{"title":"GPT-Image-2.6 Ext Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/gpt-image-2.6-ext/generation"}]},{"group":"Seedream-4.0","icon":"image","pages":[{"title":"Generación de imágenes Seedream-4.0","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-4/generation"}]},{"group":"Seedream-4.5","icon":"image","pages":[{"title":"Generación de imágenes Seedream-4.5","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-4.5/generation"}]},{"group":"Seedream-5.0-Lite","icon":"image","pages":[{"title":"Generación de imágenes Seedream-5.0-Lite","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-5-lite/generation"}]},{"group":"Seedream-5.0-Pro","icon":"image","pages":[{"title":"Generación de imágenes Seedream-5.0-Pro","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-5-0-pro/generation"}]},{"group":"Seedream-5.0-Flash","icon":"image","pages":[{"title":"Generación de imágenes Seedream-5.0-Flash","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/seedream-5-0-flash/generation"}]},{"group":"Flux Kontext","icon":"image","pages":[{"title":"Generación y edición de imágenes con FLUX Kontext","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-kontext/generation"}]},{"group":"Flux 2.0","icon":"image","pages":[{"title":"Generación de imágenes con FLUX.2","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-2/generation"}]},{"group":"FLUX 3 Image","icon":"image","pages":[{"title":"FLUX 3 Image Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-3-image/generation"}]},{"group":"FLUX 3 Image Klein","icon":"image","pages":[{"title":"FLUX 3 Image Klein Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/flux-3-image-klein/generation"}]},{"group":"Hy-Image-3.5 Preview","icon":"image","pages":[{"title":"Hy-Image-3.5 Preview Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/hy-image-v3.5-preview/generation"}]},{"group":"Muse Image Ext","icon":"image","pages":[{"title":"Generación de imágenes Muse Image Ext","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/muse-image-ext/generation"}]},{"group":"MAI-Image-2.6","icon":"image","pages":[{"title":"MAI-Image-2.6 Generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/mai-image-2.6/generation"}]},{"group":"Qwen Image 2.0","icon":"image","pages":[{"title":"Generación de imágenes Qwen Image 2.0","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/qwen-image/generation"}]},{"group":"Qwen Image 3.0","icon":"image","pages":[{"title":"Generación de imágenes Qwen Image 3.0","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/qwen-image-3.0/generation"}]},{"group":"Z-Image-Turbo","icon":"image","pages":[{"title":"Generación de imágenes Z-Image-Turbo","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/z-image-turbo/generation"}]},{"group":"Grok Imagine","icon":"image","pages":[{"title":"Grok Imagine generación de imágenes","description":" - Modo asíncrono, devuelve un ID de tarea para consultas posteriores - Admite text-to-image y edición con imagen de referencia - Los enlaces de imagen generados son válidos 24 horas; guárdelos a tiempo ","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine/generation"}]},{"group":"Grok Imagine 2.0 Ext","icon":"image","pages":[{"title":"Grok Imagine 2.0 Ext generación de imágenes","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/generation"},{"title":"Capas y edición de regiones de Grok Imagine 2.0 Ext","description":"Usa segment para obtener capas de objetos y máscaras precisas, y edita polígonos, cuadros u objetos detectados con region_edit.","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/layer-region-edit"},{"title":"Grok Imagine Image 2.0 — generación y edición oficiales","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/grok-imagine-2.0-ext/official"}]},{"group":"wan2.7-image","icon":"image","pages":[{"title":"Generación y edición de imágenes wan2.7","api":"POST https://api.apimart.ai/v1/images/generations","href":"/es/api-reference/images/wan2.7-image/generation"}]},{"group":"Midjourney","icon":"image","pages":[{"title":"API de Midjourney","href":"/es/api-reference/images/midjourney/generation"},{"title":"Imagine (texto a imagen)","api":"POST https://api.apimart.ai/v1/midjourney/generations","href":"/es/api-reference/images/midjourney/imagine"},{"title":"Blend (mezcla de varias imágenes)","api":"POST https://api.apimart.ai/v1/midjourney/generations/blend","href":"/es/api-reference/images/midjourney/blend"},{"title":"Describe (imagen a texto)","api":"POST https://api.apimart.ai/v1/midjourney/generations/describe","href":"/es/api-reference/images/midjourney/describe"},{"title":"Edits (edición de imagen)","api":"POST https://api.apimart.ai/v1/midjourney/generations/edits","href":"/es/api-reference/images/midjourney/edits"},{"title":"Upscale (ampliar una baldosa)","api":"POST https://api.apimart.ai/v1/midjourney/generations/upscale","href":"/es/api-reference/images/midjourney/upscale"},{"title":"Variation (variación)","api":"POST https://api.apimart.ai/v1/midjourney/generations/variation","href":"/es/api-reference/images/midjourney/variation"},{"title":"High Variation (variación fuerte)","api":"POST https://api.apimart.ai/v1/midjourney/generations/high-variation","href":"/es/api-reference/images/midjourney/high-variation"},{"title":"Low Variation (variación sutil)","api":"POST https://api.apimart.ai/v1/midjourney/generations/low-variation","href":"/es/api-reference/images/midjourney/low-variation"},{"title":"Reroll (regenerar)","api":"POST https://api.apimart.ai/v1/midjourney/generations/reroll","href":"/es/api-reference/images/midjourney/reroll"},{"title":"Zoom (zoom out)","api":"POST https://api.apimart.ai/v1/midjourney/generations/zoom","href":"/es/api-reference/images/midjourney/zoom"},{"title":"Pan (paneo)","api":"POST https://api.apimart.ai/v1/midjourney/generations/pan","href":"/es/api-reference/images/midjourney/pan"},{"title":"Inpaint (Vary Region)","api":"POST https://api.apimart.ai/v1/midjourney/generations/inpaint","href":"/es/api-reference/images/midjourney/inpaint"},{"title":"Modal (enviar parámetros)","api":"POST https://api.apimart.ai/v1/midjourney/generations/modal","href":"/es/api-reference/images/midjourney/modal"},{"title":"Video (imagen a video)","api":"POST https://api.apimart.ai/v1/midjourney/generations/video","href":"/es/api-reference/images/midjourney/video"},{"title":"Remix (reshape, solo v8.1 / v8.2)","api":"POST https://api.apimart.ai/v1/midjourney/generations/remix-strong","href":"/es/api-reference/images/midjourney/remix"},{"title":"Consultar tarea","api":"GET https://api.apimart.ai/v1/midjourney/{task_id}","href":"/es/api-reference/images/midjourney/query"},{"title":"Buenas prácticas","href":"/es/api-reference/images/midjourney/best-practices"},{"title":"Ejemplo de flujo de trabajo completo","href":"/es/api-reference/images/midjourney/workflow"}]}]},{"group":"Serie de video","icon":"video","pages":[{"group":"seedance-1-0-pro","icon":"video","pages":[{"title":"Generación de video seedance-1-0-pro","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/doubao/generation"}]},{"group":"seedance-1-5-pro","icon":"video","pages":[{"title":"Generación de video seedance-1-5-pro","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/seedance-1-5-pro/generation"}]},{"group":"seedance-2-0","icon":"video","pages":[{"title":"Generación de video seedance-2.0","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/seedance-2-0/generation"},{"title":"Assets de avatar virtual","api":"POST https://api.apimart.ai/v1/seedance2/private-avatar","href":"/es/api-reference/videos/seedance-2-0/private-avatar"}]},{"group":"seedance-2-5","icon":"video","pages":[{"title":"seedance-2.5 Video Generation","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/seedance-2-5/generation"}]},{"group":"VEO3","icon":"video","pages":[{"title":"Generación de video VEO3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/veo3/generation"},{"title":"Remix de video VEO3","api":"POST https://api.apimart.ai/v1/videos/{task_id}/remix","href":"/es/api-reference/videos/veo3/remix"},{"title":"Generación de video VEO3 Oficial","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/veo3/generation-official"}]},{"group":"MiniMax-Hailuo-02","icon":"video","pages":[{"title":"Generación de video MiniMax-Hailuo-02","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-hailuo/generation"}]},{"group":"MiniMax-Hailuo-2.3","icon":"video","pages":[{"title":"Generación de Video MiniMax-Hailuo-2.3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-hailuo-2.3/generation"}]},{"group":"MiniMax-H3","icon":"video","pages":[{"title":"Generación de Video MiniMax-H3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/generation"},{"title":"Generación de vídeo MiniMax-H3-Max","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/max"},{"title":"MiniMax-H3 Context-IR mejora de prompt","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/context-ir"},{"title":"MiniMax-H3 Regeneration","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/minimax-h3/regeneration"}]},{"group":"FLUX 3 Video","icon":"video","pages":[{"title":"Generación de vídeo FLUX 3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/flux-3-video/generation"}]},{"group":"SkyReels V4","icon":"video","pages":[{"title":"Generación de Video SkyReels V4","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/skyreels-v4/generation"}]},{"group":"HappyHorse","icon":"video","pages":[{"title":"Generación de Video HappyHorse 1.0","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/happyhorse-1.0/generation"},{"title":"Generación de Video HappyHorse 1.1","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/happyhorse-1.1/generation"}]},{"group":"Wan3.0","icon":"video","pages":[{"title":"Generación de vídeo Wan3.0","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan3.0-video/generation"}]},{"group":"Wan2.7","icon":"video","pages":[{"title":"Generación de Video Wan2.7","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.7/generation"},{"title":"Wan2.7-R2V Reference-to-Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.7-r2v/generation"},{"title":"Edición de Video Wan2.7-VideoEdit","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.7-videoedit/generation"}]},{"group":"Wan2.6","icon":"video","pages":[{"title":"Generación de Video Wan2.6","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.6/generation"},{"title":"wan2.6-i2v-flash Image-to-Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.6/i2v-flash-generation"}]},{"group":"Wan2.5","icon":"video","pages":[{"title":"Generación de Video wan2.5-preview","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/wan2.5/generation"}]},{"group":"Kling 2.6","icon":"video","pages":[{"title":"Generación de Video Kling 2.6","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v2-6/generation"},{"title":"Generación de video con control de movimiento Kling v2.6","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v2-6/kling-v2-6-motion-control-generation"}]},{"group":"Kling v3","icon":"video","pages":[{"title":"Generación de video Kling v3","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v3/generation"}]},{"group":"Kling 3.0 Turbo","icon":"video","pages":[{"title":"Generación de video Kling 3.0 Turbo","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-3.0-turbo/generation"}]},{"group":"Kling v3 Omni","icon":"video","pages":[{"title":"Generación de video Kling v3 Omni","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v3-omni/generation"}]},{"group":"Kling V4","icon":"video","pages":[{"title":"Kling V4 Generación de vídeos","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v4/generation"}]},{"group":"Kling V4 Flash","icon":"video","pages":[{"title":"Kling V4 Flash Generación de vídeos","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-v4-flash/generation"}]},{"group":"Kling Video O1","icon":"video","pages":[{"title":"Generación de video Kling Video O1","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/kling-video-o1/generation"}]},{"group":"Vidu Q3(pro/turbo)","icon":"video","pages":[{"title":"Generación de video Vidu Q3 (pro/turbo)","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/vidu-q3-pro/generation"}]},{"group":"Vidu Q4 Preview","icon":"video","pages":[{"title":"Vidu Q4 Preview Generación de video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/vidu-q4-preview/generation"}]},{"group":"Vidu Q3(mix/standard)","icon":"video","pages":[{"title":"Vidu Q3 (mix/standard) Reference-to-Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/vidu-q3/generation"}]},{"group":"Grok Imagine","icon":"video","pages":[{"title":"Generación de video Grok Imagine 1.5","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/grok-imagine/generation"},{"title":"Modelos oficiales de vídeo Grok","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/grok-imagine/official"}]},{"group":"Pixverse v6","icon":"video","pages":[{"title":"Pixverse v6 Generación de Video","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/pixverse-v6/generation"}]},{"group":"PixVerse V6 Max","icon":"video","pages":[{"title":"PixVerse V6 Max Generación de vídeos","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/pixverse-v6-max/generation"}]},{"group":"Muse Video Ext","icon":"video","pages":[{"title":"Generación de vídeos Muse Video Ext","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/muse-video-ext/generation"}]},{"group":"gemini-omni-1.1-flash-ext","icon":"video","pages":[{"title":"Generación de video gemini-omni-1.1-flash-ext","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/omni-flash-ext/generation"}]},{"group":"gemini-omni-1.2-flash-ext","icon":"video","pages":[{"title":"Generación de video gemini-omni-1.2-flash-ext","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/gemini-omni-1.2-flash-ext/generation"}]},{"group":"Gemini Omni 1.2 Flash","icon":"video","pages":[{"title":"Generación de vídeo Gemini Omni 1.2 Flash","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/gemini-omni-1.2-flash/generation"}]},{"group":"Gemini Omni 1.1 Flash","icon":"video","pages":[{"title":"Generación de video Gemini Omni 1.1 Flash","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/gemini-omni-1.1-flash/generation"}]},{"group":"Gemini Omni Flash","icon":"video","pages":[{"title":"Generación de video Gemini Omni Flash","api":"POST https://api.apimart.ai/v1/videos/generations","href":"/es/api-reference/videos/gemini-omni-flash-preview/generation"}]}]},{"group":"Serie de audio","icon":"microphone","pages":[{"title":"Transcripción de audio Whisper-1","api":"POST https://api.apimart.ai/v1/audio/transcriptions","href":"/es/api-reference/audios/whisper-1"},{"title":"TTS Texto a voz","api":"POST https://api.apimart.ai/v1/audio/speech","href":"/es/api-reference/audios/tts"},{"group":"Flow Music","icon":"music","pages":[{"title":"Generar música","api":"POST https://api.apimart.ai/v1/music/generations","href":"/es/api-reference/audios/flow-music/music"},{"title":"Generar música con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations","href":"/es/api-reference/audios/flow-music/music-lyria-3-5"},{"title":"Generar letras","api":"POST https://api.apimart.ai/v1/music/generations/lyricsFlowMusic","href":"/es/api-reference/audios/flow-music/lyrics"},{"title":"Extensión de música","api":"POST https://api.apimart.ai/v1/music/generations/extendFlowMusic","href":"/es/api-reference/audios/flow-music/extend"},{"title":"Extensión de música con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations/extendFlowMusic","href":"/es/api-reference/audios/flow-music/extend-lyria-3-5"},{"title":"Reemplazo de fragmento","api":"POST https://api.apimart.ai/v1/music/generations/replaceFlowMusic","href":"/es/api-reference/audios/flow-music/replace"},{"title":"Reemplazo de fragmento con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations/replaceFlowMusic","href":"/es/api-reference/audios/flow-music/replace-lyria-3-5"},{"title":"Adaptación Cover","api":"POST https://api.apimart.ai/v1/music/generations/coverFlowMusic","href":"/es/api-reference/audios/flow-music/cover"},{"title":"Adaptación Cover con Lyria 3.5","api":"POST https://api.apimart.ai/v1/music/generations/coverFlowMusic","href":"/es/api-reference/audios/flow-music/cover-lyria-3-5"},{"title":"Separación de pistas","api":"POST https://api.apimart.ai/v1/music/generations/stemsFlowMusic","href":"/es/api-reference/audios/flow-music/stems"},{"title":"Subir audio","api":"POST https://api.apimart.ai/v1/music/generations/uploadAudioFlowMusic","href":"/es/api-reference/audios/flow-music/upload-audio"},{"title":"Descargar audio","api":"POST https://api.apimart.ai/v1/music/generations/downloadAudioFlowMusic","href":"/es/api-reference/audios/flow-music/download-audio"},{"title":"Renderizado de video musical","api":"POST https://api.apimart.ai/v1/music/generations/videoClipFlowMusic","href":"/es/api-reference/audios/flow-music/video-clip"},{"title":"Consultar tarea","api":"GET https://api.apimart.ai/v1/music/tasks/{task_id}","href":"/es/api-reference/audios/flow-music/query"}]},{"group":"Suno","icon":"music","pages":[{"title":"Reglas generales de Suno V6 y consulta de tareas","api":"GET https://api.apimart.ai/v1/music/tasks/{task_id}","href":"/es/api-reference/audios/suno/overview"},{"title":"Generar música","api":"POST https://api.apimart.ai/v1/music/generations","href":"/es/api-reference/audios/suno/generation"},{"title":"Generar letra","api":"POST https://api.apimart.ai/v1/music/generations/lyrics","href":"/es/api-reference/audios/suno/lyrics"},{"title":"Generación por inspiración (inspo)","api":"POST https://api.apimart.ai/v1/music/generations/inspo","href":"/es/api-reference/audios/suno/inspo"},{"title":"Generación de efectos de sonido","api":"POST https://api.apimart.ai/v1/music/generations/sounds","href":"/es/api-reference/audios/suno/sounds"},{"title":"Mejora de etiquetas","api":"POST https://api.apimart.ai/v1/music/generations/upsampleTags","href":"/es/api-reference/audios/suno/upsample-tags"},{"title":"Subir audio","api":"POST https://api.apimart.ai/v1/music/generations/uploadTask","href":"/es/api-reference/audios/suno/upload"},{"title":"Subir audio y crear una versión","api":"POST https://api.apimart.ai/v1/music/generations/uploadCover","href":"/es/api-reference/audios/suno/upload-cover"},{"title":"Subir y extender audio","api":"POST https://api.apimart.ai/v1/music/generations/uploadExtend","href":"/es/api-reference/audios/suno/upload-extend"},{"title":"Crear un modelo personalizado","api":"POST https://api.apimart.ai/v1/music/generations/createModel","href":"/es/api-reference/audios/suno/create-model"},{"title":"Continuación y extensión","api":"POST https://api.apimart.ai/v1/music/generations/extend","href":"/es/api-reference/audios/suno/extend"},{"title":"Versión de estilo","api":"POST https://api.apimart.ai/v1/music/generations/coverSong","href":"/es/api-reference/audios/suno/cover-song"},{"title":"Masterización","api":"POST https://api.apimart.ai/v1/music/generations/remaster","href":"/es/api-reference/audios/suno/remaster"},{"title":"Extracción de pistas","api":"POST https://api.apimart.ai/v1/music/generations/stems","href":"/es/api-reference/audios/suno/stems"},{"title":"Separación total de pistas","api":"POST https://api.apimart.ai/v1/music/generations/stemsAll","href":"/es/api-reference/audios/suno/stems-all"},{"title":"Añadir voz","api":"POST https://api.apimart.ai/v1/music/generations/addVocals","href":"/es/api-reference/audios/suno/add-vocals"},{"title":"Añadir acompañamiento","api":"POST https://api.apimart.ai/v1/music/generations/addInstrumental","href":"/es/api-reference/audios/suno/add-instrumental"},{"title":"Añadir pista (add stem)","api":"POST https://api.apimart.ai/v1/music/generations/addStem","href":"/es/api-reference/audios/suno/add-stem"},{"title":"Extraer Vox (obsoleto)","api":"POST https://api.apimart.ai/v1/music/generations/vox","href":"/es/api-reference/audios/suno/vox"},{"title":"Crear voz","api":"POST https://api.apimart.ai/v1/music/generations/createVoice","href":"/es/api-reference/audios/suno/create-voice"},{"title":"Persona","api":"POST https://api.apimart.ai/v1/music/generations/persona","href":"/es/api-reference/audios/suno/persona"},{"title":"Reemplazo de sección","api":"POST https://api.apimart.ai/v1/music/generations/replaceMusic","href":"/es/api-reference/audios/suno/replace-music"},{"title":"Eliminar fragmento","api":"POST https://api.apimart.ai/v1/music/generations/removeSection","href":"/es/api-reference/audios/suno/remove-section"},{"title":"Recortar audio","api":"POST https://api.apimart.ai/v1/music/generations/crop","href":"/es/api-reference/audios/suno/crop"},{"title":"Fundido de entrada","api":"POST https://api.apimart.ai/v1/music/generations/fadeIn","href":"/es/api-reference/audios/suno/fade-in"},{"title":"Fundido de salida","api":"POST https://api.apimart.ai/v1/music/generations/fadeOut","href":"/es/api-reference/audios/suno/fade-out"},{"title":"Ajustar la velocidad","api":"POST https://api.apimart.ai/v1/music/generations/adjustSpeed","href":"/es/api-reference/audios/suno/adjust-speed"},{"title":"Síntesis / ensamblaje de la canción completa","api":"POST https://api.apimart.ai/v1/music/generations/concat","href":"/es/api-reference/audios/suno/concat"},{"title":"Generar mashup","api":"POST https://api.apimart.ai/v1/music/generations/mashup","href":"/es/api-reference/audios/suno/mashup"},{"title":"Muestra a canción (sample)","api":"POST https://api.apimart.ai/v1/music/generations/sample","href":"/es/api-reference/audios/suno/sample"},{"title":"Generar MIDI","api":"POST https://api.apimart.ai/v1/music/generations/midi","href":"/es/api-reference/audios/suno/midi"},{"title":"Línea de tiempo de la letra","api":"POST https://api.apimart.ai/v1/music/generations/alignedLyrics","href":"/es/api-reference/audios/suno/aligned-lyrics"},{"title":"Análisis de BPM","api":"POST https://api.apimart.ai/v1/music/generations/bpm","href":"/es/api-reference/audios/suno/bpm"},{"title":"Generar vídeo musical (MV)","api":"POST https://api.apimart.ai/v1/music/generations/generateMp4","href":"/es/api-reference/audios/suno/generate-mp4"},{"title":"Descargar archivos de audio","api":"POST https://api.apimart.ai/v1/music/generations/download","href":"/es/api-reference/audios/suno/wav"}]}]},{"group":"Serie de Moderación","icon":"shield-check","pages":[{"group":"omni-moderation-latest","icon":"shield-check","pages":[{"title":"omni-moderation-latest Moderación de contenido","api":"POST https://api.apimart.ai/v1/moderations","href":"/es/api-reference/moderations/omni-moderation-latest/generation"}]}]},{"group":"Gestión de subidas","icon":"cloud-arrow-up","pages":[{"title":"Subir imagen","api":"POST https://api.apimart.ai/v1/uploads/images","href":"/es/api-reference/uploads/images"},{"title":"Subir vídeo","api":"POST https://api.apimart.ai/v1/uploads/videos","href":"/es/api-reference/uploads/videos"},{"title":"Subir audio","api":"POST https://api.apimart.ai/v1/uploads/audios","href":"/es/api-reference/uploads/audios"}]},{"group":"Gestión de tareas","icon":"list-check","pages":[{"title":"Obtener estado de la tarea","api":"GET https://api.apimart.ai/v1/tasks/{task_id}","href":"/es/api-reference/tasks/status"},{"title":"Devolución de llamada al completar la tarea (Webhook)","href":"/es/api-reference/tasks/webhook"}]},{"group":"Gestión de cuenta","icon":"wallet","pages":[{"title":"Consultar saldo del token","api":"GET https://api.apimart.ai/v1/balance","href":"/es/api-reference/account/token-balance"},{"title":"Consultar saldo del usuario","api":"GET https://api.apimart.ai/v1/user/balance","href":"/es/api-reference/account/user-balance"},{"title":"Consultar gastos y uso","api":"GET https://api.apimart.ai/v1/usage","href":"/es/api-reference/account/usage"}]}]},{"tab":"Integraciones","pages":[{"title":"Integraciones","href":"/es/integrations/chat/chatbox"}]},{"tab":"Guías","pages":[{"title":"Guías","href":"/es/quickstart"}]},{"tab":"Preguntas frecuentes","pages":[{"title":"Preguntas frecuentes","href":"/es/faqs"}]}]}]},"basePath":"","title":"Grok Imagine 2.0 Ext generación de imágenes - APIMart","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js"]}