@acedatacloud/skills 2026.905.1 → 2026.909.0

package/README.md

@@ -26,6 +26,7 @@ Compatible with **30+ AI coding agents** via the [agentskills.io](https://agents
 
 | Skill | Description |
 |-------|-------------|
+| [gpt-image-2-5](skills/gpt-image-2-5/) | Generate and edit images with GPT Image 2.5 Flare or Sunburst |
 | [flux-image](skills/flux-image/) | Generate and edit images with Flux (Black Forest Labs) |
 | [qwen-image](skills/qwen-image/) | Generate and edit images with Qwen Image 3 |
 | [seedream-image](skills/seedream-image/) | Generate and edit images with ByteDance Seedream |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.905.1",
+  "version": "2026.909.0",
   "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
   "keywords": [
     "agent-skills",

package/skills/gpt-image-2-5/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: gpt-image-2-5
+description: Generate or edit images with GPT Image 2.5 Flare or Sunburst through AceDataCloud. Choose Flare for speed or Sunburst for high-fidelity control; never use the unsupported bare gpt-image-2.5 name.
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
+---
+
+# GPT Image 2.5
+
+Use one exact model ID for every request:
+
+- `gpt-image-2.5-flare` — faster generation.
+- `gpt-image-2.5-sunburst` — higher-fidelity output and editing control.
+
+Do not send `gpt-image-2.5`; it is not a model ID.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Generate
+
+```bash
+curl -X POST https://api.acedata.cloud/openai/images/generations \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"model":"gpt-image-2.5-flare","prompt":"A clean product photograph on a pale studio background, no text","size":"1024x1024","n":1}'
+```
+
+## Edit
+
+```bash
+curl -X POST https://api.acedata.cloud/openai/images/edits \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -F "model=gpt-image-2.5-sunburst" \
+  -F "prompt=Keep the subject and composition; change only the background to dark navy." \
+  -F "image=@input.png" \
+  -F "size=1024x1024" \
+  -F "n=1"
+```
+
+The result is in `data[].url`.
+
+## Shared contract
+
+- `size` may be `auto` or `WIDTHxHEIGHT`.
+- Custom dimensions use multiples of 16, max side 3840, 655,360–8,294,400 pixels, and aspect ratio at most 3:1.
+- `quality` accepts `auto`, `low`, `medium`, or `high`.
+- `n` accepts 1–10 and billing uses the number of images returned. Use URL output for `n>1`; `b64_json` requires `n=1`.
+- For long jobs, pass `async: true` or `callback_url`, then poll `POST /openai/tasks` with `{"id":"<task_id>"}`.
+- Image editing accepts URL input in JSON or local files with multipart form data.

package/skills/suno-music/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: suno-music
-description: Generate AI music with Suno via AceDataCloud API. Use when creating songs from text prompts, generating lyrics, extending tracks, creating covers, extracting vocals, managing voice personas, or any music generation task. Supports text-to-music, custom styles, multi-format output (MP3, WAV, MIDI, MP4), and vocal separation.
+description: Generate AI music with Suno via AceDataCloud API. Use when creating songs from text prompts, generating lyrics, extending tracks, creating covers, extracting vocals, managing voice personas, training custom music models from authorized audio, or any music generation task. Supports text-to-music, custom styles, multi-format output (MP3, WAV, MIDI, MP4), and vocal separation.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -130,6 +130,67 @@ For best results follow this multi-step workflow:
 | `samples` | Add samples to an uploaded song |
 | `inspo` | Generate a song inspired by an existing audio |
 
+## Custom Music Models (Beta)
+
+Custom models learn reusable musical characteristics from 6–24 authorized audio files. Creation is a paid, long-running operation. Ask the user to confirm the files and cost before submitting it.
+
+### Create
+
+```json
+POST /suno/custom-models
+{
+  "action": "create",
+  "name": "My Album Sound",
+  "audio_urls": [
+    "https://cdn.example.com/track-01.mp3",
+    "https://cdn.example.com/track-02.mp3",
+    "https://cdn.example.com/track-03.mp3",
+    "https://cdn.example.com/track-04.mp3",
+    "https://cdn.example.com/track-05.mp3",
+    "https://cdn.example.com/track-06.mp3"
+  ]
+}
+```
+
+Send a stable `Idempotency-Key` header and reuse it after network failures. Save the returned `id`; query it until `status` is `ready`.
+
+### Query and list
+
+```json
+POST /suno/custom-models
+{"action": "retrieve", "id": "<custom-model-id>"}
+```
+
+```json
+POST /suno/custom-models
+{"action": "retrieve_batch", "status": "ready", "limit": 20, "offset": 0}
+```
+
+### Generate
+
+```json
+POST /suno/custom-models
+{
+  "action": "generate",
+  "id": "<ready-custom-model-id>",
+  "lyric": "[Verse]\nOriginal lyrics here",
+  "style": "warm indie pop",
+  "title": "New Song",
+  "async": true
+}
+```
+
+Async acceptance is not terminal success: poll the returned task and inspect `response.success`. A custom-model request never falls back to another model. The model must belong to the current Suno application and have `status: "ready"`.
+
+### Archive
+
+```json
+POST /suno/custom-models
+{"action": "delete", "id": "<custom-model-id>"}
+```
+
+`delete` archives the platform resource and prevents further use. `capacity_released: false` means it does not promise that model capacity was released.
+
 ## Auxiliary Endpoints
 
 | Endpoint | Method | Purpose |
@@ -148,6 +209,7 @@ For best results follow this multi-step workflow:
 | `/suno/persona` | DELETE | Delete a reusable persona |
 | `/suno/upload` | POST | Upload external audio for extend/cover |
 | `/suno/tasks` | POST | Query task status and results |
+| `/suno/custom-models` | POST | Create, generate with, query, list, or archive custom music models |
 
 ## Advanced Parameters