---
name: apimart-model-api
description: Use when an agent needs APIMART model discovery, pricing/limits/policy evidence, verified price estimation, Seedance 2.5 request construction, video generation, or asynchronous task polling. Prefer discovery evidence and a dry-run before any paid API call.
---

# APIMART model API

1. Run `python apimart_cli.py models` to inspect all discoverable model hubs and the `verified_execution` flag.
2. Run `python apimart_cli.py guides MODEL --intent pricing|limits|commercial_policy` and re-check the linked observation-dated evidence.
3. Treat `discovery_only` as navigation evidence, not permission to invent an endpoint or request schema.
4. For Seedance 2.5 execution, read `references/seedance-2-5-generation.md` before constructing a request.
5. Run `python apimart_cli.py estimate --resolution 720p --duration 5` to expose expected cost.
6. Run `python apimart_cli.py generate ...` without `--execute` first and inspect its JSON payload.
7. Only add `--execute` after the user explicitly approves the paid call and `APIMART_API_KEY` is present.
8. Poll returned tasks with `python apimart_cli.py status TASK_ID` until `completed` or `failed`.
9. Never request 4K from the Seedance 2.5 endpoint; use only 480p, 720p or 1080p.

For MCP clients, launch `python apimart_mcp.py`; the same dry-run-first rule applies to `apimart_generate_video`.
