From e7e873dada930f362944850075d6a89b881e2a91 Mon Sep 17 00:00:00 2001 From: Anil-matcha Date: Sun, 30 Aug 2026 07:53:09 +0530 Subject: [PATCH] fix(design): document MuAPI model contracts --- .claude/skills/design/SKILL.md | 9 ++++++--- .claude/skills/design/references/logo-design.md | 9 ++++++--- .../skills/design/scripts/logo/tests/test_generate.py | 8 ++++---- cli/assets/skills/design/SKILL.md | 9 ++++++--- cli/assets/skills/design/references/logo-design.md | 9 ++++++--- .../skills/design/scripts/logo/tests/test_generate.py | 8 ++++---- 6 files changed, 32 insertions(+), 20 deletions(-) diff --git a/.claude/skills/design/SKILL.md b/.claude/skills/design/SKILL.md index 96d51a3..31de559 100644 --- a/.claude/skills/design/SKILL.md +++ b/.claude/skills/design/SKILL.md @@ -314,9 +314,12 @@ export MUAPI_API_KEY="your-key" MuAPI uses the asynchronous model endpoint and prediction result API. See the [MuAPI API reference](https://muapi.ai/docs/api-reference) for authentication -and current model contracts. The logo generator currently supports the -`nano-banana` and `nano-banana-pro` model slugs, and sends only the shared -`prompt` and `aspect_ratio` fields. +and the [nano-banana model contract](https://api.muapi.ai/api/v1/models/nano-banana) +or [nano-banana-pro model contract](https://api.muapi.ai/api/v1/models/nano-banana-pro) +for the current model-specific schemas. The logo generator supports both documented +model slugs and sends their shared required `prompt` plus optional `aspect_ratio` +fields; the Pro model also accepts an optional `resolution` field that this focused +logo workflow leaves at the provider default. > **Note for Windows:** Use `python` instead of `pip` where needed (e.g., `python -m pip install ...`). diff --git a/.claude/skills/design/references/logo-design.md b/.claude/skills/design/references/logo-design.md index c662402..a240e96 100644 --- a/.claude/skills/design/references/logo-design.md +++ b/.claude/skills/design/references/logo-design.md @@ -102,6 +102,9 @@ export MUAPI_API_KEY="your-key" MuAPI uses the asynchronous model endpoint and prediction result API. See the [MuAPI API reference](https://muapi.ai/docs/api-reference) for authentication -and current model contracts. The logo generator currently supports the -`nano-banana` and `nano-banana-pro` model slugs, and sends only the shared -`prompt` and `aspect_ratio` fields. +and the [nano-banana model contract](https://api.muapi.ai/api/v1/models/nano-banana) +or [nano-banana-pro model contract](https://api.muapi.ai/api/v1/models/nano-banana-pro) +for the current model-specific schemas. The logo generator supports both documented +model slugs and sends their shared required `prompt` plus optional `aspect_ratio` +fields; the Pro model also accepts an optional `resolution` field that this focused +logo workflow leaves at the provider default. diff --git a/.claude/skills/design/scripts/logo/tests/test_generate.py b/.claude/skills/design/scripts/logo/tests/test_generate.py index 11faa7d..d1adb98 100644 --- a/.claude/skills/design/scripts/logo/tests/test_generate.py +++ b/.claude/skills/design/scripts/logo/tests/test_generate.py @@ -136,12 +136,12 @@ class MuapiGenerationTests(unittest.TestCase): self, json_request, sleep, download ): json_request.side_effect = [ - {"request_id": "req-123"}, - {"request_id": "req-123", "status": "processing"}, + {"id": "req-123", "status": "created"}, + {"id": "req-123", "status": "processing"}, { - "request_id": "req-123", + "id": "req-123", "status": "completed", - "outputs": ["https://media.example.com/logo.png"], + "output": {"outputs": ["https://media.example.com/logo.png"]}, }, ] diff --git a/cli/assets/skills/design/SKILL.md b/cli/assets/skills/design/SKILL.md index 96d51a3..31de559 100644 --- a/cli/assets/skills/design/SKILL.md +++ b/cli/assets/skills/design/SKILL.md @@ -314,9 +314,12 @@ export MUAPI_API_KEY="your-key" MuAPI uses the asynchronous model endpoint and prediction result API. See the [MuAPI API reference](https://muapi.ai/docs/api-reference) for authentication -and current model contracts. The logo generator currently supports the -`nano-banana` and `nano-banana-pro` model slugs, and sends only the shared -`prompt` and `aspect_ratio` fields. +and the [nano-banana model contract](https://api.muapi.ai/api/v1/models/nano-banana) +or [nano-banana-pro model contract](https://api.muapi.ai/api/v1/models/nano-banana-pro) +for the current model-specific schemas. The logo generator supports both documented +model slugs and sends their shared required `prompt` plus optional `aspect_ratio` +fields; the Pro model also accepts an optional `resolution` field that this focused +logo workflow leaves at the provider default. > **Note for Windows:** Use `python` instead of `pip` where needed (e.g., `python -m pip install ...`). diff --git a/cli/assets/skills/design/references/logo-design.md b/cli/assets/skills/design/references/logo-design.md index c662402..a240e96 100644 --- a/cli/assets/skills/design/references/logo-design.md +++ b/cli/assets/skills/design/references/logo-design.md @@ -102,6 +102,9 @@ export MUAPI_API_KEY="your-key" MuAPI uses the asynchronous model endpoint and prediction result API. See the [MuAPI API reference](https://muapi.ai/docs/api-reference) for authentication -and current model contracts. The logo generator currently supports the -`nano-banana` and `nano-banana-pro` model slugs, and sends only the shared -`prompt` and `aspect_ratio` fields. +and the [nano-banana model contract](https://api.muapi.ai/api/v1/models/nano-banana) +or [nano-banana-pro model contract](https://api.muapi.ai/api/v1/models/nano-banana-pro) +for the current model-specific schemas. The logo generator supports both documented +model slugs and sends their shared required `prompt` plus optional `aspect_ratio` +fields; the Pro model also accepts an optional `resolution` field that this focused +logo workflow leaves at the provider default. diff --git a/cli/assets/skills/design/scripts/logo/tests/test_generate.py b/cli/assets/skills/design/scripts/logo/tests/test_generate.py index 11faa7d..d1adb98 100644 --- a/cli/assets/skills/design/scripts/logo/tests/test_generate.py +++ b/cli/assets/skills/design/scripts/logo/tests/test_generate.py @@ -136,12 +136,12 @@ class MuapiGenerationTests(unittest.TestCase): self, json_request, sleep, download ): json_request.side_effect = [ - {"request_id": "req-123"}, - {"request_id": "req-123", "status": "processing"}, + {"id": "req-123", "status": "created"}, + {"id": "req-123", "status": "processing"}, { - "request_id": "req-123", + "id": "req-123", "status": "completed", - "outputs": ["https://media.example.com/logo.png"], + "output": {"outputs": ["https://media.example.com/logo.png"]}, }, ]