MODELKIWI / DEVELOPERS

Exemplos de API

Da primeira chamada ao seu fluxo.

Guarde a chave em MODELKIWI_API_KEY no ambiente local. Python usa a biblioteca padrão; Node.js requer 22+. Executar os exemplos pode gerar cobrança. Não há tentativas automáticas.

Defina a chave

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

No zsh padrão do macOS, execute bash antes do comando read acima. Você também pode usar seu gerenciador de segredos. Não coloque a chave no frontend ou Git.

Chat Completions: texto e visão

Interface compatível tradicional. Visão requer um modelo multimodal; use --image-url.

Python 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

Baixar Python · Baixar Node.js

Vision · example URL

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses: texto e visão

Interface OpenAI Responses com grok-4.7. O canal precisa suportar esse protocolo.

Python 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

Baixar Python · Baixar Node.js

Anthropic Messages: pré-requisito

Claude ainda não está no catálogo. Habilite o canal e informe o modelo com --model.

Python 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Baixar Python · Baixar Node.js

API nativa Gemini

Envie texto por generateContent usando o ID exato do modelo.

Python 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

Baixar Python · Baixar Node.js

Imagens: o endpoint correto

POST https://api.modelkiwi.com/v1/images/generations

Use grok-imagine-image ou grok-imagine-image-quality. Os scripts do skill identificam o formato real e salvam o arquivo. Veja o tutorial de imagens; seleção 2K, referência e edição não estão validadas.

Skill, scripts e parâmetros de imagem ↗

Vídeo: crie, consulte e baixe

Na ModelKiwi use POST /v1/videos, com duration e resolution. A rota difere de /v1/videos/generations do site de referência.

Python 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

Python ↧ · Node.js ↧

Etapa	Rota e campos
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

Duração padrão 8 s, faixa 1–15 s. Versão comum: 480p/720p; versão 1.5 também 1080p. Cobrança por segundo. O script envia uma única tarefa. Se expirar, retome com --task ID em vez de gerar de novo.

Resolva erros

HTTP	Verifique
401 / 403	Chave, cota e permissões.
404	Protocolo e caminho; imagens/vídeos não usam Chat.
400 / 无可用渠道	ID exato, grupo default e compatibilidade do canal.
429 / 5xx	Guarde o request ID, reduza concorrência e confira tarefas/uso antes de repetir.

ModelKiwi · 2026-10-19 · Todos os tutoriais

MODELKIWI / DEVELOPERS

API 脚本接入

从一次请求，到完整工作流。

所有密钥仅保存在本地环境变量 MODELKIWI_API_KEY。Python 示例使用标准库；Node.js 示例要求 22+。示例执行会产生真实费用，没有自动重试。

先设置密钥

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

macOS 默认 zsh 请先运行 bash 后使用上面的 read 命令。或通过你自己的密钥管理工具注入环境变量。不要把真实密钥放进前端代码或 Git。

Chat Completions：文本与视觉

传统兼容接口。视觉需要选择真正支持图片理解的模型；可以传 --image-url。

Python 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

下载 Python 脚本 · 下载 Node.js 脚本

Vision · example URL

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses：文本与视觉

新式 OpenAI 接口，模型示例 grok-4.7。上游渠道必须支持 Responses。

Python 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

下载 Python 脚本 · 下载 Node.js 脚本

Anthropic Messages：接入条件

当前公开目录没有 Claude；先开通对应渠道再使用，模型通过 --model 明确指定。

Python 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

下载 Python 脚本 · 下载 Node.js 脚本

Gemini 原生接口

按 Gemini generateContent 协议发送文本，使用本站准确模型 ID。

Python 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

下载 Python 脚本 · 下载 Node.js 脚本

图片生成：正确的图片端点

POST https://api.modelkiwi.com/v1/images/generations

使用 grok-imagine-image 或 grok-imagine-image-quality。通过图片 Skill 的 Node/Python 脚本自动识别真实格式并保存图片，详见图片教程。当前不承诺 2K 选择、参考图和编辑接口可用。

图片 Skill、脚本和完整参数 ↗

视频生成：提交、查询、下载

本站提交端点是 POST /v1/videos，使用 duration 与 resolution。不是参考站的 /v1/videos/generations，也不是聊天端点。

Python 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

Python ↧ · Node.js ↧

步骤	接口与字段
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

默认 8 秒，可选 1–15 秒。普通版 480p/720p；1.5 版另有 1080p。按秒计费。脚本只提交一次，超时后保留任务 ID；用 --task ID 继续查询，避免再次扣费。

错误排查

HTTP	检查项
401 / 403	本站密钥、额度、令牌权限。
404	协议和完整路径，不要把图片/视频发送到聊天端点。
400 / 无可用渠道	准确模型名、default 分组和上游协议适配。
429 / 5xx	保留 request ID，降低并发；重试前检查用量与任务。

ModelKiwi · 2026-10-19 · 返回全部教程

MODELKIWI / DEVELOPERS

API Examples

From the first call to your flow.

Store the key in MODELKIWI_API_KEY in the local environment. Python uses the standard library; Node.js requires 22+. Running the examples may incur charges. There are no automatic attempts.

Set the key

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

In macOS's default zsh, run bash before the read command above. You can also use your secrets manager. Don't put the key in the frontend or Git.

Chat Completions: text and vision

Traditional compatible interface. Vision requires a multimodal model; use --image-url.

Python 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

Download Python · Download Node.js

Vision · example URL

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses: text and vision

OpenAI interface Responses with grok-4.7. The channel must support this protocol.

Python 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

Download Python · Download Node.js

Anthropic Messages: prerequisite

Claude is not yet in the catalogue. Enable the channel and enter the model with --model.

Python 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Download Python · Download Node.js

Native API Gemini

Send text by generateContent using the exact model ID.

Python 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

Download Python · Download Node.js

Images: the correct endpoint

POST https://api.modelkiwi.com/v1/images/generations

Use grok-imagine-image or grok-imagine-image-quality. The skill scripts identify the actual format and save the file. See the image tutorial; 2K selection, reference and editing are not validated.

Skill, scripts and image parameters ↗

Video: create, consult and download

In ModelKiwi use POST /v1/videos, with duration and resolution. The route differs from /v1/videos/generations of the reference site.

Python 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

Python ↧ · Node.js ↧

Step	Route and fields
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

Default duration 8 s, range 1–15 s. Common version: 480p/720p; version 1.5 also 1080p. Charge per second. The script submits a single task. If it expires, resume with --task ID instead of generating again.

Solve errors

HTTP	Check
401 / 403	Key, quota and permissions.
404	Protocol and path; images/videos do not use Chat.
400 / 无可用渠道	Exact ID, default group and channel compatibility.
429/5xx	Save the request ID, reduce competition and check tasks/usage before repeating.

ModelKiwi · 2026-10-19 · All tutorials

MODÈLEKIWI / DÉVELOPPEURS

Exemples d'API

Du premier appel à votre flux.

Stockez la clé dans MODELKIWI_API_KEY dans l'environnement local. Python utilise la bibliothèque standard ; Node.js nécessite 22+. L’exécution des exemples peut entraîner des frais. Il n'y a pas de tentatives automatiques.

Définir la clé

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

Dans le zsh par défaut de macOS, exécutez bash avant la commande read ci-dessus. Vous pouvez également utiliser votre gestionnaire de secrets. Ne mettez pas la clé dans le frontend ou dans Git.

Achèvements du chat : texte et vision

Interface compatible traditionnelle. La vision nécessite un modèle multimodal ; utiliser --image-url.

Python 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

Télécharger Python · Télécharger Node.js

Vision · exemple d'URL

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses : texte et vision

Interface OpenAI Responses avec grok-4.7. Le canal doit prendre en charge ce protocole.

Python 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

Télécharger Python · Télécharger Node.js

Anthropic Messages : prérequis

Claude n'est pas encore au catalogue. Activez le canal et entrez le modèle avec --model.

Python 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Télécharger Python · Télécharger Node.js

API native Gemini

Envoyez du texte par generateContent en utilisant l'ID exact du modèle.

Python 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

Télécharger Python · Télécharger Node.js

Images : le bon point final

POST https://api.modelkiwi.com/v1/images/generations

Utilisez grok-imagine-image ou grok-imagine-image-quality.. Les scripts de skills identifient le format réel et enregistrent le fichier. Voir le didacticiel en images ; La sélection, la référence et l'édition 2K ne sont pas validées.

Compétence, scripts et paramètres d'image ↗

Vidéo : créer, consulter et télécharger

Dans ModelKiwi, utilisez POST /v1/videos, avec durée et résolution. Le parcours diffère du /v1/videos/generations du site de référence.

Python 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

Python ↧ · Node.js ↧

Étape	Itinéraire et champs
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

Durée par défaut 8 s, plage 1–15 s. Version commune : 480p/720p ; la version 1.5 également 1080p. Charge par seconde. Le script soumet une seule tâche. S'il expire, reprenez avec l'ID --task au lieu de générer à nouveau.

Résoudre les erreurs

HTTP	Vérifier
401 / 403	Clé, quota et autorisations.
404	Protocole et chemin ; les images/vidéos n’utilisent pas le chat.
400 / 无可用渠道	ID exact, compatibilité de groupe et de canal par défaut.
429/5xx	Enregistrez l'ID de la demande, réduisez la concurrence et vérifiez les tâches/l'utilisation avant de répéter.

ModelKiwi · 2026-10-19 · Tous les tutoriels

МОДЕЛЬКИВИ / РАЗРАБОТЧИКИ

Примеры API

От первого звонка до вашего потока.

Сохраните ключ в MODELKIWI_API_KEY в локальной среде. Python использует стандартную библиотеку; Node.js требует 22+. За выполнение примеров может взиматься плата. Автоматических попыток нет.

Установить ключ

Терминал · Баш

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

Терминал · Баш

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

В zsh по умолчанию macOS запустите bash перед приведенной выше командой чтения. Вы также можете использовать свой менеджер секретов. Не помещайте ключ во внешний интерфейс или Git.

Завершения чата: текст и изображение

Традиционный совместимый интерфейс. Видение требует мультимодальной модели; используйте --image-url.

Питон 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

Скачать Python · Скачать Node.js

Видение · пример URL

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses: текст и изображение

Интерфейс OpenAI Responses с grok-4.7. Канал должен поддерживать этот протокол.

Питон 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

Скачать Python · Скачать Node.js

Anthropic Messages: необходимое условие.

Claude пока нет в каталоге. Включите канал и введите модель с помощью --model..

Питон 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Скачать Python · Скачать Node.js

Собственный API Gemini

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

Питон 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

Скачать Python · Скачать Node.js

Изображения: правильная конечная точка

POST https://api.modelkiwi.com/v1/images/generations

Используйте grok-imagine-image или grok-imagine-image-quality.. Сценарии навыков определяют фактический формат и сохраняют файл. См. учебник по изображениям; Выбор 2K, ссылки и редактирование не проверяются.

Навыки, скрипты и параметры изображения ↗

Видео: создать, просмотреть и скачать

В ModelKiwi используйте POST /v1/videos с указанием продолжительности и разрешения. Маршрут отличается от /v1/videos/generations справочного сайта.

Питон 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

Питон ↧ · Node.js ↧

Шаг	Маршрут и поля
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

Длительность по умолчанию 8 с, диапазон 1–15 с. Обычная версия: 480p/720p; версия 1.5 тоже 1080p. Плата за секунду. Скрипт отправляет одну задачу. Если срок его действия истек, возобновите работу с идентификатором --task вместо повторной генерации.

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

HTTP	Проверить
401 / 403	Ключ, квота и разрешения.
404	Протокол и путь; изображения/видео не используют чат.
400 / 无可用渠道	Точный идентификатор, группа по умолчанию и совместимость каналов.
429/5xx	Сохраните идентификатор запроса, уменьшите конкуренцию и проверьте задачи/использование перед повторением.

ModelKiwi · 19.10.2026 · Все уроки

MODELKIWI / 開発者

API の例

最初の呼び出しからフローまで。

ローカル環境の MODELKIWI_API_KEY にキーを保存します。 Python は標準ライブラリを使用します。 Node.js には 22 歳以上が必要です。サンプルの実行には料金が発生する場合があります。自動試行はありません。

キーを設定する

ターミナル・バッシュ

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

ターミナル・バッシュ

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

macOS のデフォルトの zsh では、上記の read コマンドの前に bash を実行します。シークレットマネージャーを使用することもできます。フロントエンドや Git にキーを置かないでください。

チャット補完: テキストとビジョン

従来の互換インターフェイス。ビジョンにはマルチモーダルモデルが必要です。 --image-url.を使用

Python 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

Pythonをダウンロード · Node.jsをダウンロード

ビジョン・URL例

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses: テキストとビジョン

OpenAI インターフェイス Responses と grok-4.7. チャネルはこのプロトコルをサポートする必要があります。

Python 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

Pythonをダウンロード · Node.jsをダウンロード

Anthropic Messages: 前提条件

Claude はまだカタログに掲載されていません。チャネルを有効にし、--model. でモデルを入力します。

Python 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Pythonをダウンロード · Node.jsをダウンロード

ネイティブ API Gemini

正確なテンプレート ID を使用して、generateContent によってテキストを送信します。

Python 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

Pythonをダウンロード · Node.jsをダウンロード

画像: 正しいエンドポイント

POST https://api.modelkiwi.com/v1/images/generations

grok-imagine-image または grok-imagine-image-quality. を使用してください。スキルスクリプトは実際の形式を識別し、ファイルを保存します。画像チュートリアルを参照してください。 2Kの選択、参照、編集は未検証です。

スキル、スクリプト、画像パラメータ ↗

ビデオ: 作成、参照、ダウンロード

ModelKiwi では、期間と解像度を指定して POST /v1/videos を使用します。参考サイトの/v1/videos/generationsとはルートが異なります。

Python 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

パイソン ↧ · Node.js ↧

ステップ	ルートとフィールド
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

デフォルトの継続時間は 8 秒、範囲は 1 ～ 15 秒です。共通バージョン: 480p/720p;バージョン 1.5 も 1080p。 1秒あたりの充電。スクリプトは単一のタスクを送信します。有効期限が切れた場合は、再度生成するのではなく、--task ID で再開します。

エラーを解決する

HTTP	チェック
401 / 403	キー、クォータ、および権限。
404	プロトコルとパス。画像/動画はチャットを使用しません。
400 / 無可用渠道	正確な ID、デフォルトのグループ、チャネルの互換性。
429/5xx	リクエスト ID を保存し、競合を減らし、タスクや使用状況を確認してから繰り返します。

ModelKiwi · 2026-10-19 · すべてのチュートリアル

MODELKIWI / NHÀ PHÁT TRIỂN

Ví dụ về API

Từ cuộc gọi đầu tiên đến luồng của bạn.

Lưu trữ khóa trong MODELKIWI_API_KEY trong môi trường cục bộ. Python sử dụng thư viện chuẩn; Node.js yêu cầu 22+. Việc chạy các ví dụ có thể phải chịu phí. Không có nỗ lực tự động.

Đặt chìa khóa

Nhà ga · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

Nhà ga · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

Trong zsh mặc định của macOS, hãy chạy bash trước lệnh đọc ở trên. Bạn cũng có thể sử dụng trình quản lý bí mật của mình. Đừng đặt chìa khóa ở lối vào hoặc Git.

Hoàn thành trò chuyện: văn bản và hình ảnh

Giao diện tương thích truyền thống. Tầm nhìn đòi hỏi một mô hình đa phương thức; sử dụng --image-url.

Python 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

Tải xuống Python · Tải xuống Node.js

Tầm nhìn · URL mẫu

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses: văn bản và tầm nhìn

Giao diện OpenAI Responses với grok-4.7. Kênh phải hỗ trợ giao thức này.

Python 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

Tải xuống Python · Tải xuống Node.js

Anthropic Messages: điều kiện tiên quyết

Claude chưa có trong danh mục. Kích hoạt kênh và nhập mô hình với --model.

Python 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Tải xuống Python · Tải xuống Node.js

API gốc Gemini

Gửi văn bản bằng generateContent bằng ID mẫu chính xác.

Python 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

Tải xuống Python · Tải xuống Node.js

Hình ảnh: điểm cuối chính xác

POST https://api.modelkiwi.com/v1/images/generations

Sử dụng grok-imagine-image hoặc grok-imagine-image-quality. Các tập lệnh kỹ năng xác định định dạng thực tế và lưu tệp. Xem hướng dẫn bằng hình ảnh; Lựa chọn, tham chiếu và chỉnh sửa 2K không được xác thực.

Kỹ năng, kịch bản và thông số hình ảnh ↗

Video: tạo, tham khảo và tải về

Trong ModelKiwi sử dụng POST /v1/videos, kèm theo thời lượng và độ phân giải. Tuyến đường khác với /v1/videos/generations của trang tham chiếu.

Python 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

Trăn ↧ · Node.js ↧

Bước	Tuyến đường và cánh đồng
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

Thời lượng mặc định là 8 giây, trong khoảng 1–15 giây. Phiên bản phổ biến: 480p/720p; phiên bản 1.5 cũng 1080p. Tính phí mỗi giây. Kịch bản gửi một nhiệm vụ duy nhất. Nếu hết hạn, hãy tiếp tục với ID --task thay vì tạo lại.

Giải quyết lỗi

HTTP	Kiểm tra
401 / 403	Khóa, hạn ngạch và quyền.
404	Giao thức và đường dẫn; hình ảnh/video không sử dụng Trò chuyện.
400 / 无可用渠道	ID chính xác, khả năng tương thích nhóm và kênh mặc định.
429/5xx	Lưu ID yêu cầu, giảm tính cạnh tranh và kiểm tra nhiệm vụ/cách sử dụng trước khi lặp lại.

ModelKiwi · 2026-10-19 · Tất cả hướng dẫn

MODELKIWI / DEVELOPERS

API 指令碼接入

從一次請求，到完整工作流。

所有金鑰僅儲存在本地環境變數 MODELKIWI_API_KEY。Python 示例使用標準庫；Node.js 示例要求 22+。示例執行會產生真實費用，沒有自動重試。

先設定金鑰

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

PowerShell

$secret = Read-Host "ModelKiwi API Key" -AsSecureString
$env:MODELKIWI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password

Terminal · Bash

read -s -p "ModelKiwi API Key: " MODELKIWI_API_KEY; echo
export MODELKIWI_API_KEY

macOS 預設 zsh 請先執行 bash 後使用上面的 read 命令。或透過你自己的金鑰管理工具注入環境變數。不要把真實金鑰放進前端程式碼或 Git。

Chat Completions：文字與視覺

傳統相容介面。視覺需要選擇真正支援圖片理解的模型；可以傳 --image-url。

Python 3

python3 modelkiwi-api.py --endpoint chat --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint chat --prompt "Olá, ModelKiwi"

下載 Python 指令碼 · 下載 Node.js 指令碼

Vision · example URL

python3 modelkiwi-api.py --endpoint chat --model gemini-3.8-flash --prompt "Descreva a imagem" --image-url "https://example.com/image.jpg"

Responses：文字與視覺

新式 OpenAI 介面，模型示例 grok-4.7。上游渠道必須支援 Responses。

Python 3

python3 modelkiwi-api.py --endpoint responses --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint responses --prompt "Olá, ModelKiwi"

下載 Python 指令碼 · 下載 Node.js 指令碼

Anthropic Messages：接入條件

當前公開目錄沒有 Claude；先開通對應渠道再使用，模型透過 --model 明確指定。

Python 3

python3 modelkiwi-api.py --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint messages --model YOUR_AUTHORIZED_CLAUDE_MODEL --prompt "Olá, ModelKiwi"

下載 Python 指令碼 · 下載 Node.js 指令碼

Gemini 原生介面

按 Gemini generateContent 協議傳送文字，使用本站準確模型 ID。

Python 3

python3 modelkiwi-api.py --endpoint gemini --prompt "Olá, ModelKiwi"

Node.js 22+

node modelkiwi-api.mjs --endpoint gemini --prompt "Olá, ModelKiwi"

下載 Python 指令碼 · 下載 Node.js 指令碼

圖片生成：正確的圖片端點

POST https://api.modelkiwi.com/v1/images/generations

使用 grok-imagine-image 或 grok-imagine-image-quality。透過圖片 Skill 的 Node/Python 指令碼自動識別真實格式並儲存圖片，詳見圖片教程。當前不承諾 2K 選擇、參考圖和編輯介面可用。

圖片 Skill、指令碼和完整引數 ↗

影片生成：提交、查詢、下載

本站提交端點是 POST /v1/videos，使用 duration 與 resolution。不是參考站的 /v1/videos/generations，也不是聊天端點。

Python 3

python3 modelkiwi-video.py --model grok-imagine-video --prompt "Um kiwi sobre a mesa, câmera lenta" --duration 8 --resolution 720p

Node.js 22+

node modelkiwi-video.mjs --model grok-imagine-video-1.5 --prompt "Um kiwi sobre a mesa" --duration 8 --resolution 1080p

Python ↧ · Node.js ↧

步驟	介面與欄位
1	`POST /v1/videos` → `id`
2	`GET /v1/videos/{id}` → `status`
3	`GET /v1/videos/{id}/content` → MP4

預設 8 秒，可選 1–15 秒。普通版 480p/720p；1.5 版另有 1080p。按秒計費。指令碼只提交一次，超時後保留任務 ID；用 --task ID 繼續查詢，避免再次扣費。

錯誤排查

HTTP	檢查項
401 / 403	本站金鑰、額度、令牌許可權。
404	協議和完整路徑，不要把圖片/影片傳送到聊天端點。
400 / 無可用渠道	準確模型名、default 分組和上游協議適配。
429 / 5xx	保留 request ID，降低併發；重試前檢查用量與任務。

ModelKiwi · 2026-10-19 · 返回全部教程