modelkiwiDocs
Voltar ao site ↗
MODELKIWI / GUIA DE IMAGENS

Da ideia à imagem.

Instale uma vez. Depois, descreva sua ideia e deixe sua IA criar com os modelos Grok pela ModelKiwi.

Instalar o skill ↓
POST/v1/images/generationsGrok Images
Use uma chave ModelKiwi. Uma chave do provedor original não substitui a chave da sua conta.

01Instale com um comando

Escolha seu sistema. O instalador verifica o Node.js 18+, baixa o skill completo, pede o cliente e salva a chave localmente. Nenhuma imagem é gerada durante a instalação.

Abra o Terminal e cole o comando.

Terminal · Bash
curl -fsSL https://www.modelkiwi.com/install/image-gen.sh | bash
  1. Escolha o cliente. Codex, Claude Code, OpenCode, OpenClaw, Hermes ou um diretório personalizado.
  2. Cole sua chave ModelKiwi. A entrada fica oculta. Crie a chave em Chaves de API no grupo default, com acesso ao modelo desejado.
  3. Reinicie ou recarregue o cliente. Peça: “Use $modelkiwi-image-gen para criar um pôster verde minimalista.”
PRONTO PARA CRIAR

modelkiwi-image-gen

O instalador confere os arquivos e mantém backup da versão anterior. Outros skills e as configurações de modelos do cliente são preservados.

Ambiente, local da chave e clientes

Se Node.js estiver ausente ou antigo, o script oferece instalar o LTS via nvm em macOS/Linux ou winget no Windows. É necessário aceitar a etapa; se preferir, instale pelo site oficial e execute novamente. O cliente de IA deve suportar skills locais e execução de scripts.

Chave salva em ~/.config/modelkiwi/.env(macOS/Linux,respeita XDG_CONFIG_HOME),%APPDATA%\modelkiwi\.env(Windows)。Os arquivos de chave e backups contêm segredos; não envie ao Git. A variável IMAGE_GEN_API_KEY tem prioridade sobre o arquivo.

Codex usa ~/.codex/skills; Claude Code usa ~/.claude/skills. O script também oferece outros clientes e diretório personalizado. Para um workspace OpenClaw personalizado, selecione seu diretório real.

Leia a instalação completa e a restauração de backups ↗

02Escolha o modelo

Grok · xAI

Dois modelos, a mesma interface.

ModeloQuando escolher
grok-imagine-imageCriação geral de imagens a partir de texto.
grok-imagine-image-qualityAlternativa de qualidade; compare o resultado e o preço para o seu projeto.

A disponibilidade e os preços vigentes estão no catálogo de modelos. Esta página não fixa preços nem garante disponibilidade do provedor.

03Ou peça à sua IA para instalar

Copie esta instrução para um assistente que consiga ler URLs, instalar skills e executar scripts locais. A chave fica na sua máquina.

Instalação por IA
Instale e habilite o skill ModelKiwi seguindo:
https://www.modelkiwi.com/install/skill/modelkiwi-image-gen/INSTALL.md
Instale a pasta completa para o cliente que estou usando, sem substituir outros skills.
Se não houver terminal interativo, use a opção --no-config e mantenha a chave existente.
Leia IMAGE_GEN_API_KEY ou o arquivo de configuração privado criado pelo instalador.
Não peça para eu publicar a chave no chat, nem a registre no código ou no Git.
Quando eu pedir uma imagem pela ModelKiwi, use os scripts do skill e salve o resultado localmente.

Depois de instalar, basta descrever

Prompt
Use $modelkiwi-image-gen para criar uma campanha de perfume minimalista, com luz da manhã e fundo verde-menta, sem texto.

Para o modelo de qualidade, peça explicitamente grok-imagine-image-quality. A geração consome saldo conforme o catálogo. Se preferir integrar sua aplicação diretamente, consulte os exemplos de API abaixo.

04Faça uma chamada

O endpoint de criação de imagens é POST /v1/images/generations. Use a URL completa abaixo; SDKs que acrescentam o caminho automaticamente usam a base https://api.modelkiwi.com/v1.

cURL
curl https://api.modelkiwi.com/v1/images/generations \
  -H "Authorization: Bearer $IMAGE_GEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "A minimalist perfume campaign, morning light, soft mint backdrop, no text",
    "n": 1,
    "response_format": "b64_json"
  }'

O cURL retorna JSON com a imagem em Base64. Para salvar o arquivo automaticamente, use Python 3, sem dependências externas:

Python 3
import base64
import json
import os
from pathlib import Path
from urllib.request import Request, urlopen

payload = {
    "model": "grok-imagine-image",
    "prompt": "A minimalist perfume campaign, morning light, soft mint backdrop, no text",
    "n": 1,
    "response_format": "b64_json",
}
request = Request(
    "https://api.modelkiwi.com/v1/images/generations",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["IMAGE_GEN_API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
with urlopen(request, timeout=300) as response:
    result = json.load(response)
image = base64.b64decode(result["data"][0]["b64_json"], validate=True)
if image.startswith(b"\x89PNG\r\n\x1a\n"):
    extension = "png"
elif image.startswith(b"\xff\xd8\xff"):
    extension = "jpg"
elif image[:4] == b"RIFF" and image[8:12] == b"WEBP":
    extension = "webp"
else:
    raise ValueError("Unexpected image format; inspect the response")
output = Path("generated-image." + extension)
output.write_bytes(image)
print(output.resolve())
Baixar exemplo Python ↗

Salve como generate-image.py e execute python3 generate-image.py após definir a variável de ambiente. O arquivo é salvo na pasta atual. Uma execução faz uma chamada real e pode consumir saldo.

05Parâmetros

CampoTipoUso neste guia
modelstring · obrigatórioUm dos dois modelos Grok listados acima.
promptstring · obrigatórioDescrição da imagem.
nintegerUse 1 para gerar uma imagem; outros limites dependem do provedor.
response_formatstringb64_json ou url. O exemplo usa Base64.

Não é uma chamada de chat: messages, temperature e streaming de texto não fazem parte deste exemplo.

06Leia a resposta

Na resposta JSON, procure data. Com b64_json, decodifique data[0].b64_json; com url, leia data[0].url e baixe a imagem enquanto o link estiver disponível. Não acrescente sua chave de API ao URL da imagem.

Estrutura ilustrativa
{
  "data": [
    { "b64_json": "<BASE64_DA_IMAGEM>" }
  ]
}

Os campos adicionais dependem do provedor. A extensão do arquivo deve corresponder ao conteúdo real — a resposta pode não ser PNG. Não espere que o cURL salve uma imagem diretamente: ele retorna JSON.

07Recursos disponíveis

DISPONÍVEL NA INTERFACE

Texto → imagem

Envio de modelo, prompt, quantidade e formato de retorno.

A CONFIRMAR

2K, referências e edição

O canal atual não encaminha integralmente os campos de tamanho, resolução ou imagem de referência. Não presuma que enviar esses campos ativa o recurso.

O catálogo pode exibir faixas 1K / 2K de cobrança. Isso, por si só, não comprova que a seleção de resolução está disponível neste canal. Este guia cobre a geração padrão por texto; edição e imagens de referência precisam de validação específica da integração.

08Resolva erros

SintomaO que verificar
401 / chave inválidaChave ModelKiwi e cabeçalho Authorization: Bearer.
Sem canal disponívelGrupo default, nome exato do modelo, permissão do token e canal habilitado.
Saldo ou quota insuficienteSaldo da conta, quota e validade do token.
429 / limite de taxaReduza a concorrência; aguarde antes de tentar novamente.
400 / parâmetro inválidoUse o payload mínimo deste guia e confira a mensagem do provedor.
Timeout / 5xxGuarde o request ID para suporte. Confira os registros antes de repetir: a primeira chamada pode ter sido processada.
ModelKiwi · 2026-10-19
Estrutura inspirada no guia do provedor
МОДЕЛЬКИВИ / РУКОВОДСТВО ПО ИЗОБРАЖЕНИЯМ

От идеи к образу.

Установить один раз. Затем опишите свою идею и позвольте вашему ИИ творить с помощью моделей Grok от ModelKiwi.

Установить навык ↓
ПОСТ/v1/images/generationsGrok Изображения
Используйте ключ ModelKiwi. Ключ от исходного поставщика не заменяет ключ вашей учетной записи.

01Установка одной командой

Выберите свою систему. Установщик проверяет Node.js 18+, загружает полный навык, запрашивает у клиента и сохраняет ключ локально. Во время установки изображения не создаются.

Откройте терминал и вставьте команду.

Терминал · Баш
curl -fsSL https://www.modelkiwi.com/install/image-gen.sh | bash
  1. Выбрать клиента. Codex, Claude Code, OpenCode, OpenClaw, Hermes или собственный каталог.
  2. Вставьте свой ключ ModelKiwi. Вход скрыт. Создайте ключ в API-ключи в группе по умолчанию, с доступом к нужной модели.
  3. Перезапустите или перезагрузите клиент. Спросите: «Используйте $modelkiwi-image-gen, чтобы создать минималистичный зеленый плакат».
ГОТОВЫ СОЗДАТЬ

modelkiwi-image-gen

Установщик проверяет файлы и сохраняет резервную копию предыдущей версии. Остальные навыки и настройки шаблона клиента сохраняются.

Окружающая среда, ключевое местоположение и клиенты

Если Node.js отсутствует или устарел, скрипт предлагает установить LTS через nvm на macOS/Linux или winget на Windows. Необходимо принять шаг; Если хотите, установите его с официального сайта и запустите еще раз. AI-клиент должен поддерживать локальные навыки и выполнение скриптов.

Ключ сохранен в ~/.config/modelkiwi/.env(macOS/Linux,уважает XDG_CONFIG_HOME),%APPDATA%\modelkiwi\.env(Windows)。Файлы ключей и резервные копии содержат секреты; не привязывайтесь к Git. Переменная IMAGE_GEN_API_KEY имеет приоритет над файлом.

Codex использует ~/.codex/skills; Claude Code использует ~/.claude/skills.. Сценарий также предлагает других клиентов и собственный каталог. Для пользовательского рабочего пространства OpenClaw выберите свой реальный каталог.

Прочитать полную установку и восстановление из резервных копий ↗

02Выберите модель

Grok · xAI

Две модели, одинаковый интерфейс.

МодельКогда выбирать
grok-imagine-imageОбщее создание изображений из текста.
grok-imagine-image-qualityКачественная альтернатива; Сравните результат и цену для вашего проекта.

Наличие и текущие цены указаны в каталог моделей Ключ. На этой странице не устанавливаются цены и не гарантируется доступность поставщика.

03Или попросите свой ИИ установить

Скопируйте эту инструкцию в мастер, который может читать URL-адреса, устанавливать навыки и запускать локальные сценарии. Ключ остается на вашей машине.

Установка ИИ
Instale e habilite o skill ModelKiwi seguindo:
https://www.modelkiwi.com/install/skill/modelkiwi-image-gen/INSTALL.md
Instale a pasta completa para o cliente que estou usando, sem substituir outros skills.
Se não houver terminal interativo, use a opção --no-config e mantenha a chave existente.
Leia IMAGE_GEN_API_KEY ou o arquivo de configuração privado criado pelo instalador.
Não peça para eu publicar a chave no chat, nem a registre no código ou no Git.
Quando eu pedir uma imagem pela ModelKiwi, use os scripts do skill e salve o resultado localmente.

После установки просто опишите

Подсказка
Use $modelkiwi-image-gen para criar uma campanha de perfume minimalista, com luz da manhã e fundo verde-menta, sem texto.

Для качественной модели явно закажите grok-imagine-image-quality. Генерация потребляет остаток согласно каталогу. Если вы предпочитаете интегрировать свое приложение напрямую, см. примеры API ниже.

04Позвонить

Конечная точка визуализации POST /v1/images/generations. Используйте полный URL-адрес ниже; SDK, которые автоматически добавляют путь, используют базовый https://api.modelkiwi.com/v1.

КУЛЬ
curl https://api.modelkiwi.com/v1/images/generations \
  -H "Authorization: Bearer $IMAGE_GEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "A minimalist perfume campaign, morning light, soft mint backdrop, no text",
    "n": 1,
    "response_format": "b64_json"
  }'

cURL возвращает JSON с изображением в Base64. Чтобы сохранить файл автоматически, используйте Python 3 без внешних зависимостей:

Питон 3
import base64
import json
import os
from pathlib import Path
from urllib.request import Request, urlopen

payload = {
    "model": "grok-imagine-image",
    "prompt": "A minimalist perfume campaign, morning light, soft mint backdrop, no text",
    "n": 1,
    "response_format": "b64_json",
}
request = Request(
    "https://api.modelkiwi.com/v1/images/generations",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["IMAGE_GEN_API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
with urlopen(request, timeout=300) as response:
    result = json.load(response)
image = base64.b64decode(result["data"][0]["b64_json"], validate=True)
if image.startswith(b"\x89PNG\r\n\x1a\n"):
    extension = "png"
elif image.startswith(b"\xff\xd8\xff"):
    extension = "jpg"
elif image[:4] == b"RIFF" and image[8:12] == b"WEBP":
    extension = "webp"
else:
    raise ValueError("Unexpected image format; inspect the response")
output = Path("generated-image." + extension)
output.write_bytes(image)
print(output.resolve())
Скачать пример Python ↗

Сохранить как generate-image.py и выполните python3 generate-image.py после установки переменной среды. Файл сохраняется в текущей папке. Выполнение выполняет фактический вызов и может потреблять баланс.

05Параметры

ПолеТипИспользуйте в этом руководстве.
modelстрока · требуетсяОдна из двух моделей Grok, перечисленных выше.
promptстрока · требуетсяОписание изображения.
nцелое числоИспользование 1 для создания изображения; остальные лимиты зависят от провайдера.
response_formatb64_json или url. В примере используется Base64.

Не разговор в чате: messages, temperature и потоковый текст не входят в этот пример.

06Читать ответ

В ответе JSON найдите data. С b64_json, декодировать data[0].b64_json; с url, читай data[0].url и загрузите изображение, пока ссылка доступна. Не добавляйте ключ API к URL-адресу изображения.

Иллюстративная структура
{
  "data": [
    { "b64_json": "<BASE64_DA_IMAGEM>" }
  ]
}

Дополнительные поля зависят от провайдера. Расширение файла должно соответствовать фактическому содержимому — ответ может быть не PNG. Не ждите, что cURL сохранит изображение напрямую: он возвращает JSON.

07Доступные ресурсы

ДОСТУПНО НА ИНТЕРФЕЙСЕ

Текст → изображение

Модель отправки, подсказка, количество и формат возврата.

ПОДТВЕРЖДАЕТСЯ

2К, ссылки и издание

Текущий канал не полностью пересылает поля размера, разрешения или эталонного изображения. Не думайте, что отправка этих полей активирует эту функцию.

В каталоге могут отображаться диапазоны выставления счетов 1K/2K. Само по себе это не доказывает, что на этом канале доступен выбор разрешения. В этом руководстве рассматривается генерация стандартов по тексту; Редактирование и эталонные изображения требуют проверки, зависящей от интеграции.

08Устранение ошибок

СимптомЧто проверить
401 / неверный ключModelKiwi Ключ и заголовок Authorization: Bearer.
Нет доступных каналов.Группа default, точное название модели, разрешение токена и включенный канал.
Недостаточно баланса или квотыБаланс аккаунта, квота и срок действия токена.
429 / предел скоростиСнизить конкуренцию; Пожалуйста, подождите, прежде чем повторить попытку.
400 / неверный параметрИспользуйте минимальную полезную нагрузку, указанную в этом руководстве, и проверьте сообщение провайдера.
Тайм-аут / 5xxПожалуйста, сохраните идентификатор запроса на поддержку. Прежде чем повторить, проверьте журналы: возможно, первый вызов был обработан.
ModelKiwi · 19.10.2026
Структура, вдохновленная руководством для поставщиков.