> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to CometAPI

The CometAPI connector lets your AI agent act in each user's CometAPI account. Each user connects their own CometAPI access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 37 tools.

**Authentication:** Bearer Token
**Categories:** AI
**Tools:** 37: 15 read, 22 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=COMETAPI)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the CometAPI connection

   In **AgentKit > Connections**, create a CometAPI connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'cometapi'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize CometAPI:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'cometapi_api_key_usage_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "cometapi"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize CometAPI:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="cometapi_api_key_usage_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their CometAPI credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'cometapi_api_key_usage_get',
  toolInput: {},
  connector: 'cometapi',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="cometapi_api_key_usage_get",
    tool_input={},
    connection_name="cometapi",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `cometapi_api_key_usage_get`

Get API Key Usage · Read-only

Get the quota, usage, expiration and model limits of the connected CometAPI API key.
Returns the key's name, total and used quota, remaining quota, expiry and allowed models.
Use this to check the remaining balance before large jobs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `cometapi_flux_result_get`

Get FLUX Result · Read-only

Get the status and result of a FLUX image task.
Returns id, status and, when Ready, result.sample with the image URL.
Use this after cometapi_flux_image_generate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Task ID returned by cometapi_flux_image_generate. Example: 6f2c1a7e-8b3d-4e5f-9a0b-1c2d3e4f5a6b.

Example input: `{"id":"<id>"}`

### `cometapi_grok_video_get`

Get Grok Video Task · Read-only

Get the status and result of a Grok video task.
Returns the status and, when done, the video URL and details.
Use this after cometapi_grok_video_generate.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `request_id` (`string`, required): Request ID returned by cometapi_grok_video_generate. Example: d2f1e3a4-5b6c-7d8e-9f01-23456789abcd.

Example input: `{"request_id":"<request_id>"}`

### `cometapi_hunyuan3d_job_get`

Get Hunyuan 3D Job · Read-only

Get the status and result files of a Hunyuan 3D job.
Returns the job status and, when done, the generated 3D files.
Use this after cometapi_hunyuan3d_job_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): Job ID returned by cometapi_hunyuan3d_job_create. Example: 1234567890123456789.

Example input: `{"job_id":"<job_id>"}`

### `cometapi_image_task_get`

Get Image Generation Task · Read-only

Get the status and result of an asynchronous image generation task.
Returns the task status and, when finished, the image data.
Use this after cometapi_image_generate with async true.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `task_id` (`string`, required): Task ID from data.task_id of the async image request. Example: task_01JABCDEF.

Example input: `{"task_id":"<task_id>"}`

### `cometapi_kling_task_get`

Get Kling Task · Read-only

Get the status and result of a Kling image, video or audio task.
Returns code and data with task_id, task_status and, when succeed, task_result with the video or image URLs.
Use this after a Kling create tool, with the same resource and sub-action the task was created with.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `resource` (`string`, required): Resource type of the task: images, videos or audio. Example: videos. One of: `images`, `videos`, `audio`.
- `sub_action` (`string`, required): Sub-action the task was created with, such as text2video or image2video for videos, or generations for images. Example: text2video.
- `task_id` (`string`, required): Kling task ID from data.task_id. Example: CjhVQGbpLk0AAAAAAAAAA.

Example input: `{"resource":"images","sub_action":"<sub_action>","task_id":"<task_id>"}`

### `cometapi_midjourney_task_get`

Get Midjourney Task · Read-only

Get the status and result of one Midjourney task.
Returns the task with status, progress, imageUrl, prompt and buttons (the customIds for follow-up actions).
Use this to poll a task. Use cometapi_midjourney_tasks_list for several tasks at once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Midjourney task ID returned in result by a submit tool. Example: 1712345678901234.

Example input: `{"id":"<id>"}`

### `cometapi_midjourney_tasks_list`

List Midjourney Tasks by ID · Read-only

Get the status and results of several Midjourney tasks at once.
Returns one task object per ID, with status, progress, imageUrl and buttons.
Use this to poll many tasks. Use cometapi_midjourney_task_get for one task.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): Array of Midjourney task ids to retrieve. Returns the current status and result for each. Defaults to ["example"]. Example: ["1712345678901234", "1712345678905678"]

Example input: `{"ids":["1712345678901234","1712345678905678"]}`

### `cometapi_minimax_video_get`

Get MiniMax Video Task · Read-only

Get the status of a MiniMax video generation task.
Returns task_id, status and, when Success, file_id for the video.
Use this after cometapi_minimax_video_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `task_id` (`string`, required): Task ID returned by cometapi_minimax_video_create. Example: 106916112212032.

Example input: `{"task_id":"<task_id>"}`

### `cometapi_models_list`

List Models · Read-only

List the models available through CometAPI.
Returns the model catalog with each model's ID, provider and type.
Use this to pick a model ID for the generation tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `cometapi_replicate_prediction_get`

Get Replicate Prediction · Read-only

Get the status and output of a Replicate prediction.
Returns id, status, output and any error.
Use this after cometapi_replicate_prediction_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Prediction ID returned by cometapi_replicate_prediction_create. Example: q7r8s9t0abcd.

Example input: `{"id":"<id>"}`

### `cometapi_runway_task_get`

Get Runway Task · Read-only

Get the status and output of a Runway task.
Returns id, status, progress and, when SUCCEEDED, output (the result URLs).
Use this after a Runway create tool.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Task ID returned by a Runway create tool. Example: 17f20503-6c24-4c16-946b-35dbbce2af2f.

Example input: `{"id":"<id>"}`

### `cometapi_suno_task_get`

Get Suno Task · Read-only

Get the status and result of one Suno music or lyrics task.
Returns the task with status, progress and data (clips with audio_url, image_url, title and duration, or the lyrics).
Use this to poll a task. Use cometapi_suno_tasks_list for several tasks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `task_id` (`string`, required): Task ID from a Suno submit tool. Example: 736a6f88-bd29-4b1e-b110-37132a5325ac.

Example input: `{"task_id":"<task_id>"}`

### `cometapi_suno_tasks_list`

List Suno Tasks by ID · Read-only

Get the status and results of several Suno tasks at once.
Returns one task object per ID with status and data.
Use this to poll many tasks. Use cometapi_suno_task_get for one task.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `action` (`string`, required): Task type: MUSIC or LYRICS. Defaults to MUSIC. Example: MUSIC.
- `ids` (`array`, required): Suno task IDs to look up. Defaults to ["example"]. Example: ["736a6f88-bd29-4b1e-b110-37132a5325ac"]

Example input: `{"action":"<action>","ids":["736a6f88-bd29-4b1e-b110-37132a5325ac"]}`

### `cometapi_video_job_get`

Get Video Job · Read-only

Get the status of a video job created through CometAPI's /v1/videos API (Sora 2, Veo 3, Vidu, Wan, Seedance and others).
Returns id, model, status, progress and, when completed, the video details.
Use this to poll a video job or a cometapi_sora_video_remix job.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `video_id` (`string`, required): Video job ID returned when the job was created. Example: video_68e688d4950481918ec389280c2f78140fcb904657674466.

Example input: `{"video_id":"<video_id>"}`

### `cometapi_chat_completion_create`

Create Chat Completion · Write

Generate a chat reply with any model CometAPI routes to (GPT, Claude, Gemini, Grok, DeepSeek, Qwen, Llama and others) through the OpenAI-compatible Chat Completions API.
Returns id, model, choices (each with message content and any tool_calls, and finish_reason) and usage token counts.
Use this for most text generation. Use cometapi_response_create for the OpenAI Responses API, cometapi_message_create for the Anthropic Messages format, or cometapi_gemini_content_generate for the Gemini format.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `messages` (`array`, required): Conversation messages, each with a role (system, developer, user, assistant or tool) and content. Defaults to [{"role": "developer", "content": "You are a helpful assistant."}, {"role": "user", "content": "Hello!"}]. Example: [{"role": "user", "content": "Summarize the plot of Hamlet in two sentences."}]
- `model` (`string`, required): Model ID to use, such as gpt-4o-mini, claude-sonnet-4-5 or gemini-2.5-flash. Get model IDs from cometapi_models_list. Defaults to gpt-6-astra. Example: gpt-4o-mini.
- `frequency_penalty` (`number`, optional): Number between -2.0 and 2.0. Positive values penalize tokens proportionally to how often they have appeared, reducing verbatim repetition. Example: 0.
- `logprobs` (`boolean`, optional): Return token log probabilities. Use gpt-4.1 as shown in the Logprobs example. Example: false.
- `max_completion_tokens` (`integer`, optional): Maximum generated tokens, including visible output and reasoning. Leave enough room for both, as in the image-input example. Example: 1024.
- `max_tokens` (`integer`, optional): Legacy output-token limit. Use max_completion_tokens for the GPT-6 Astra examples. Example: 512.
- `n` (`integer`, optional): Number of completion choices to generate for each input message. Defaults to 1. Example: 1.
- `presence_penalty` (`number`, optional): Number between -2.0 and 2.0. Positive values penalize tokens based on whether they have already appeared, encouraging the model to explore new topics. Example: 0.
- `reasoning_effort` (`string`, optional): Reasoning effort supported by the selected model. The GPT-6 Astra examples use low; the GPT-5.6 Sol function example uses none. See the model reference for other supported levels. Example: low.
- `response_format` (`object`, optional): Specifies the output format. Use {"type": "json_object"} for JSON mode, or {"type": "json_schema", "json_schema": {...}} for strict structured output. Example: {"type": "json_object"}
- `service_tier` (`string`, optional): Specifies the processing tier. Example: auto. One of: `auto`, `default`, `flex`, `priority`.
- `stop` (`array`, optional): A stop string, or a list of up to four strings, where generation stops. Example: END.
- `temperature` (`number`, optional): Sampling temperature. Omit this field for GPT-6 Astra. Example: 0.7.
- `tool_choice` (`string`, optional): Controls how the model selects tools. auto (default): model decides. none: no tools. required: must call a tool. Example: auto.
- `tools` (`array`, optional): Function definitions for a model that supports tool calling on Chat Completions. The function example uses GPT-5.6 Sol; use Responses for GPT-6 Astra tool calls. Example: [{"type": "function", "function": {"name": "get_weather", "parameters": {"type": "object", "properties": {"city": {"type": "string"}}}}}]
- `top_logprobs` (`integer`, optional): Number of most likely tokens to return at each position (0-20). Requires logprobs to be true. Example: 5.
- `top_p` (`number`, optional): Nucleus sampling threshold. Omit this field for GPT-6 Astra. For sampling overrides, adjust either top_p or temperature. Example: 1.
- `user` (`string`, optional): A unique identifier for your end-user. Helps with abuse detection and monitoring. Example: user-1234.

Example input: `{"messages":[{"role":"user","content":"Summarize the plot of Hamlet in two sentences."}],"model":"<model>"}`

### `cometapi_embeddings_create`

Create Embeddings · Write

Create vector embeddings for text with an embedding model through CometAPI.
Returns data (one embedding per input, with index and the vector), model and usage.
Use this for semantic search, clustering and retrieval.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `input` (`array`, required): The text to embed. Can be a single string, an array of strings, or an array of token arrays. Each input must not exceed the model's maximum token limit (8,191 tokens for text-embedding-3-* models). Example: The quick brown fox jumps over the lazy dog.
- `model` (`string`, required): Embedding model ID, such as text-embedding-3-small. Get model IDs from cometapi_models_list. Example: text-embedding-3-small.
- `dimensions` (`integer`, optional): The number of dimensions for the output embedding vector. Only supported by text-embedding-3-* models. Reducing dimensions can lower storage costs while maintaining most of the embedding's utility. Example: 512.
- `encoding_format` (`string`, optional): The format of the returned embedding vectors. float returns an array of floating-point numbers. base64 returns a base64-encoded string representation, which can reduce response size for large batches. Defaults to float. Example: float. One of: `float`, `base64`.
- `user` (`string`, optional): A unique identifier for your end-user, which can help monitor and detect abuse. Example: user-1234.

Example input: `{"input":[],"model":"<model>"}`

### `cometapi_flux_image_generate`

Generate FLUX Image · Write

Generate or edit an image with a Black Forest Labs FLUX model through CometAPI.
Returns a task id (and polling_url) when async, or the finished result with result.sample (the image URL) when async is false.
Use this for FLUX models. Poll cometapi_flux_result_get with the id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `model` (`string`, required): FLUX model ID, such as flux-2-pro or flux-2-flex. Example: flux-2-pro.
- `prompt` (`string`, required): Text prompt describing the image or reference-image edit. Example: A red fox in a snowy forest, cinematic lighting.
- `async_mode` (`boolean`, optional): Controls whether generation returns asynchronously. Set false to wait for the finished image and read result.sample from the successful response. Set true or omit this field to receive a task ID for polling. Use a JSON boolean, not a string. Do not combine false with webhook_url or webhook_secret. Defaults to true. Example: true.
- `height` (`integer`, optional): Requested output height in pixels. Use a dimension supported by the selected model. Example: 1024.
- `input_image` (`string`, optional): Public HTTPS URL of the first reference image. Replace the example URL with a publicly accessible image. This editing field is available for the FLUX.2 models covered by this reference. Example: https://example.com/reference.png.
- `input_image_2` (`string`, optional): Public HTTPS URL of a second reference image for flux-2-pro. Replace the example URL and also send input_image. Example: https://example.com/reference-2.png.
- `output_format` (`string`, optional): Requested output image format supported by the selected model. The examples use png. Example: png.
- `seed` (`integer`, optional): Optional seed value. A completed result can report the used seed; that field alone does not establish repeatable output. Example: 42.
- `width` (`integer`, optional): Requested output width in pixels. Use a dimension supported by the selected model. Example: 1024.

Example input: `{"model":"<model>","prompt":"[Verse]\\nA song about summer love and beach sunsets"}`

### `cometapi_gemini_content_generate`

Generate Gemini Content · Write

Generate content in the Google Gemini format through CometAPI, for Gemini models (text, and images with image-capable Gemini models).
Returns candidates (each with content parts and finishReason) and usageMetadata.
Use this when your requests use the Gemini format. Use cometapi_chat_completion_create for the OpenAI format.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contents` (`array`, required): Conversation content. Each entry has an optional role (user or model) and a parts array. For tool results, preserve the complete preceding model content, including any thoughtSignature fields. Example: [{"role": "user", "parts": [{"text": "Explain how a rainbow forms."}]}]
- `model` (`string`, required): Gemini model ID, such as gemini-2.5-flash. Get model IDs from cometapi_models_list. Example: gemini-2.5-flash.
- `generation_config` (`object`, optional): Configuration for model generation behavior including temperature, output length, and response format. Example: {"temperature": 0.7, "maxOutputTokens": 1024}
- `safety_settings` (`array`, optional): Safety filter settings. Override default thresholds for specific harm categories. Example: [{"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_ONLY_HIGH"}]
- `system_instruction` (`object`, optional): System instructions that guide the model's behavior across the entire conversation. Text only. Example: {"parts": [{"text": "Answer in one paragraph."}]}
- `tool_config` (`object`, optional): Configuration for tool usage, such as function calling mode. Example: {"functionCallingConfig": {"mode": "AUTO"}}
- `tools` (`array`, optional): Tools available to the model during generation. Use googleSearch for search grounding. Example: [{"googleSearch": {}}]

Example input: `{"contents":[],"model":"<model>"}`

### `cometapi_grok_video_generate`

Create Grok Video Task · Write

Start an xAI Grok Imagine video generation task from text, an image or reference images and audio.
Returns request_id.
Use this for Grok video. Poll cometapi_grok_video_get with the request_id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `model` (`string`, required): The Grok video model ID. Send this field explicitly so the request uses Grok Imagine Video 1.5. Example: grok-imagine-video-1.5. One of: `grok-imagine-video-1.5`.
- `prompt` (`string`, required): A description of the scene, motion, and audio. Reference-to-video prompts can identify inputs with tags such as <IMAGE_0> and <AUDIO_0>. Example: A hummingbird hovering over a red flower, slow motion.
- `aspect_ratio` (`string`, optional): The output aspect ratio. Text-to-video uses 16:9 when omitted. Image-to-video uses the source image's aspect ratio when omitted. Example: 16:9. One of: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`.
- `duration` (`integer`, optional): The output duration in seconds. Use an integer from 1 through 15. Defaults to 8. Example: 8.
- `image` (`object`, optional): Source image for image-to-video, as an object with a url (a public image URL or image data URI). Do not combine with reference_images. Example: {"url": "https://example.com/start.jpg"}
- `reference_images` (`array`, optional): Visual references for reference-to-video, 1 to 7 objects each with a url (a public image URL or image data URI). Do not combine with image. Example: [{"url": "https://example.com/ref.jpg"}]
- `resolution` (`string`, optional): The output resolution. Reference-to-video requests support 480p and 720p; text-to-video and image-to-video also support 1080p. Defaults to 480p. Example: 480p. One of: `480p`, `720p`, `1080p`.

Example input: `{"model":"grok-imagine-video-1.5","prompt":"[Verse]\\nA song about summer love and beach sunsets"}`

### `cometapi_hunyuan3d_job_create`

Create Hunyuan 3D Job · Write

Start a Tencent Hunyuan 3D job that turns an image into a 3D model.
Returns the job ID.
Use this to create a 3D mesh from an image. Poll cometapi_hunyuan3d_job_get with the job ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Tencent HY 3D Global operation name. Must be SubmitHunyuanTo3DProJob. Example: SubmitHunyuanTo3DProJob.
- `image_base64` (`string`, required): Base64-encoded primary image without a data URL prefix. Supported formats are JPG, JPEG, PNG, and WebP. Each side must be from 128 through 5,000 pixels. The encoded value must be at most 8 MB; keep the source file at or below 6 MB to allow for encoding overhead. Example: iVBORw0KGgoAAAANSUhEUgAA...
- `model` (`string`, required): Tencent HY 3D Global model version. Must be 3.1. Example: 3.1.
- `enable_pbr` (`boolean`, optional): Whether to add physically based rendering (PBR) material maps to the OBJ and MTL resource bundle for a Normal job. Defaults to false. Example: false.
- `face_count` (`integer`, optional): Target face count for the generated mesh. Treat this value as a target rather than an exact polygon guarantee. Defaults to 500000. Example: 100000.
- `generate_type` (`string`, optional): Generation mode. Choose Normal for textured output or Geometry for geometry-only output. Defaults to Normal. Example: Normal. One of: `Normal`, `Geometry`.

Example input: `{"action":"<action>","image_base64":"<image_base64>","model":"<model>"}`

### `cometapi_image_generate`

Generate Image · Write

Generate images from a text prompt with OpenAI-compatible image models (GPT Image, DALL-E, Seedream and others) through CometAPI.
Returns created and data (image URLs or base64 images), or data.task_id when async is true.
Use this for text-to-image. With async true, poll cometapi_image_task_get with the task_id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `model` (`string`, required): Image model ID, such as gpt-image-1, dall-e-3 or doubao-seedream-4-0-250828. Get model IDs from cometapi_models_list. Defaults to gpt-image-2. Example: gpt-image-1.
- `prompt` (`string`, required): Text description of the image you want to generate. Example: A watercolor painting of a lighthouse at dawn.
- `async_mode` (`boolean`, optional): CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll GET /v1/images/generations/{task_id} for the final image data. Documented model IDs for this mode: gpt-image-2 and doubao-seedream-4-0-250828. This is a CometAPI extension, not an OpenAI parameter. When async and stream are both true, async takes precedence and returns JSON task metadata instead of an SSE stream. Defaults to false. Example: false.
- `background` (`string`, optional): Background mode for the generated image. Set transparent to generate an isolated subject with no background fill; this requires output_format set to png or webp, and returns an error with jpeg. Set opaque for a solid background, or auto to let the model decide. Supported on gpt-image-2.5-sunburst and gpt-image-2.5-flare. Example: transparent. One of: `transparent`, `opaque`, `auto`.
- `moderation` (`string`, optional): Content moderation level for GPT image models. low is less restrictive; auto is the default. Example: low. One of: `low`, `auto`.
- `n` (`integer`, optional): Number of images to generate. Keep this at 1 for the broadest compatibility. Defaults to 1. Example: 1.
- `output_compression` (`integer`, optional): Compression level for the output image, from 0 to 100. Applies when output_format is webp or jpeg. Lower values produce smaller files with more compression artifacts. Defaults to 100. Example: 100.
- `output_format` (`string`, optional): The encoded image type for GPT image model results, such as png, jpeg, or webp. See the OpenAI image generation guide for current GPT image output controls. Example: png.
- `quality` (`string`, optional): Quality setting for models that support it. GPT image models accept low, medium, high, and auto. gpt-image-2.5-sunburst and gpt-image-2.5-flare also accept xhigh and max. dall-e-3 accepts standard and hd. See the OpenAI image generation guide for the latest model-specific values. Example: high.
- `response_format` (`string`, optional): The response container for dall-e-2 and dall-e-3. This parameter is not supported for GPT image models, which return base64-encoded image data. Example: url. One of: `url`, `b64_json`.
- `size` (`string`, optional): Requested output size. Supported values depend on the selected model. See the OpenAI image generation guide for the latest model-specific ranges. Example: 1024x1024.

Example input: `{"model":"<model>","prompt":"[Verse]\\nA song about summer love and beach sunsets"}`

### `cometapi_kling_image_to_video`

Create Kling Image-to-Video Task · Write

Start a Kling video generation task that animates an image.
Returns code, message and data with task_id and task_status.
Use this to animate a still image. Poll cometapi_kling_task_get with resource videos, sub-action image2video and the task_id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `image` (`string`, required): Source image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected. For base64 input, send the encoded image string as the field value. Example: https://example.com/portrait.jpg.
- `callback_url` (`string`, optional): Webhook URL to receive task status updates when the task completes. Example: https://example.com/callback.
- `cfg_scale` (`number`, optional): Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1. Example: 0.5.
- `duration` (`string`, optional): Output video length in seconds. Use 5 or 10; omit to use 5. Defaults to 5. Example: 5.
- `external_task_id` (`string`, optional): Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user. Example: order-10423.
- `image_tail` (`string`, optional): Tail-frame reference image as a Base64 string or public URL. Same format requirements as image. Controls the last frame of the generated video. Example: https://example.com/last-frame.jpg.
- `mode` (`string`, optional): Generation mode. std for standard (faster), pro for professional (higher quality). Defaults to std. Example: std. One of: `std`, `pro`.
- `model_name` (`string`, optional): Model ID for this image-to-video request. Use kling-v3 for new requests. Use Omni model IDs only with the Omni Video endpoint. Defaults to kling-v1. Example: kling-v1. One of: `kling-v1`, `kling-v1-5`, `kling-v1-6`, `kling-v2-master`, `kling-v2-1`, `kling-v2-1-master`, `kling-v2-5-turbo`, `kling-v2-6`, `kling-v3`.
- `negative_prompt` (`string`, optional): Elements to exclude from the video. Maximum 200 characters. Example: blurry, distorted.
- `prompt` (`string`, optional): Text prompt describing the desired motion. Maximum 500 characters. Example: The person slowly turns and smiles.
- `sound` (`string`, optional): Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default. Example: on. One of: `on`, `off`.

Example input: `{"image":"<image>"}`

### `cometapi_kling_text_to_video`

Create Kling Text-to-Video Task · Write

Start a Kling video generation task from a text prompt.
Returns code, message and data with task_id and task_status.
Use this for text-to-video with Kling. Poll cometapi_kling_task_get with resource videos, sub-action text2video and the task_id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `prompt` (`string`, required): Text prompt describing the video to generate. Maximum 500 characters. Example: A drone shot over a misty mountain lake at sunrise.
- `aspect_ratio` (`string`, optional): Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field. Example: 16:9. One of: `16:9`, `9:16`, `1:1`.
- `callback_url` (`string`, optional): Webhook URL to receive task status updates when the task completes. Example: https://example.com/callback.
- `camera_control` (`object`, optional): Camera motion preset or manual configuration. Omit for automatic camera movement. Example: {"type": "simple", "config": {"zoom": 5}}
- `cfg_scale` (`number`, optional): Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1. Example: 0.5.
- `duration` (`string`, optional): Output video length in seconds. Use 5 or 10; omit to use 5. Defaults to 5. Example: 5.
- `external_task_id` (`string`, optional): Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user. Example: order-10423.
- `mode` (`string`, optional): Generation mode. std for standard (faster), pro for professional (higher quality). The default is std. Example: std. One of: `std`, `pro`.
- `model_name` (`string`, optional): Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint. Defaults to kling-v1. Example: kling-v1. One of: `kling-v1`, `kling-v1-6`, `kling-v2-master`, `kling-v2-1-master`, `kling-v2-5-turbo`, `kling-v2-6`, `kling-v3`.
- `negative_prompt` (`string`, optional): Elements to exclude from the video. Maximum 200 characters. Example: blurry, low quality.
- `sound` (`string`, optional): Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default. Example: on. One of: `on`, `off`.

Example input: `{"prompt":"[Verse]\\nA song about summer love and beach sunsets"}`

### `cometapi_message_create`

Create Anthropic Message · Write

Generate a reply in the Anthropic Messages format through CometAPI, for Claude models.
Returns id, model, role, content blocks (text, thinking and tool_use), stop_reason and usage.
Use this when your prompts and tools use the Anthropic format. Use cometapi_chat_completion_create for the OpenAI format.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `max_tokens` (`integer`, required): The maximum number of tokens to generate. The model may stop before reaching this limit. When using thinking, the thinking tokens count towards this limit. Example: 1024.
- `messages` (`array`, required): Conversation history. Use user and assistant messages with text strings or content-block arrays. Return complete assistant content blocks when continuing a tool call. Example: [{"role": "user", "content": "Hello, Claude"}]
- `model` (`string`, required): Claude model ID. Get model IDs from cometapi_models_list. Defaults to claude-opus-5. Example: claude-sonnet-4-5.
- `metadata` (`object`, optional): Request metadata for tracking and analytics. Example: {"user_id": "user-1234"}
- `stop_sequences` (`array`, optional): Custom strings that cause the model to stop generating when encountered. The stop sequence is not included in the response. Example: ["END"]
- `system` (`array`, optional): System prompt providing context and instructions to Claude. Can be a plain string or an array of content blocks (useful for prompt caching). Example: You are a helpful assistant.
- `temperature` (`number`, optional): Sampling temperature. The examples omit sampling overrides. Example: 0.7.
- `thinking` (`object`, optional): Thinking configuration. The adaptive example uses type adaptive and sets output_config.effort separately. Example: {"type": "enabled", "budget_tokens": 2048}
- `tool_choice` (`object`, optional): Controls how the model uses tools. Example: {"type": "auto"}
- `tools` (`array`, optional): Client tools define a name and input_schema. Server tools use a versioned type and name, such as the web_fetch and web_search examples on this page. Example: [{"name": "get_weather", "input_schema": {"type": "object", "properties": {"city": {"type": "string"}}}}]
- `top_k` (`integer`, optional): Limits sampling to the k most likely tokens. The examples omit sampling overrides. Example: 40.
- `top_p` (`number`, optional): Nucleus sampling threshold. The examples omit sampling overrides. Example: 1.

Example input: `{"max_tokens":1024,"messages":[{"role":"user","content":"Hello, Claude"}],"model":"<model>"}`

### `cometapi_midjourney_action`

Run Midjourney Action · Write

Run a follow-up action (upscale, variation, zoom, pan, reroll) on a finished Midjourney task.
Returns code, description and result (the new task ID).
Use this with a customId from the buttons of cometapi_midjourney_task_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `custom_id` (`string`, required): Action id taken from the latest buttons array returned by the fetch endpoint. Example: MJ::JOB::upsample::1::abcd1234.
- `task_id` (`string`, required): Midjourney task id you want to continue from. Example: 1712345678901234.
- `choose_same_channel` (`boolean`, optional): Whether to prefer the same provider account used by the current task. Example: true.
- `enable_remix` (`boolean`, optional): Whether to force remix mode when the current action supports it. Example: false.
- `state` (`string`, optional): Custom state string. Returned as-is in the task result and webhook callback for your own tracking. Example: order-10423.

Example input: `{"custom_id":"<custom_id>","task_id":"<task_id>"}`

### `cometapi_midjourney_blend`

Blend Images with Midjourney · Write

Start a Midjourney blend task that merges two to five images into a new one.
Returns code, description and result (the task ID).
Use this to combine images. Poll cometapi_midjourney_task_get with the task ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `base64_array` (`array`, required): Two or more base64-encoded images to blend. Each item should be a data URI such as data:image/png;base64,xxx. Defaults to ["data:image/png;base64,<your-image-base64>"]. Example: ["data:image/png;base64,iVBORw0KGgo...", "data:image/png;base64,iVBORw0KGgo..."]
- `bot_type` (`string`, optional): Bot type to use. MID_JOURNEY for Midjourney (default), NIJI_JOURNEY for Niji. Example: MID_JOURNEY. One of: `MID_JOURNEY`, `NIJI_JOURNEY`.
- `dimensions` (`string`, optional): Output aspect ratio. Example: PORTRAIT. One of: `PORTRAIT`, `SQUARE`, `LANDSCAPE`.
- `state` (`string`, optional): Custom state string. Returned as-is in the task result and webhook callback for your own tracking. Example: order-10423.

Example input: `{"base64_array":["data:image/png;base64,iVBORw0KGgo...","data:image/png;base64,iVBORw0KGgo..."]}`

### `cometapi_midjourney_describe`

Describe Image with Midjourney · Write

Start a Midjourney describe task that writes text prompts for an image.
Returns code, description and result (the task ID); the finished task holds the suggested prompts.
Use this to get prompts from an image. Send either link or base64.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `base64` (`string`, optional): Base64-encoded image to describe. Use a data URI such as data:image/png;base64,xxx. Provide either base64 or link. Defaults to data:image/png;base64,<your-image-base64>. Example: data:image/png;base64,iVBORw0KGgo...
- `bot_type` (`string`, optional): Bot type to use. MID_JOURNEY for Midjourney (default), NIJI_JOURNEY for Niji. Example: NIJI_JOURNEY. One of: `NIJI_JOURNEY`, `MID_JOURNEY`.
- `link` (`string`, optional): URL of the image to describe. Provide either link or base64. Defaults to https://your-image-host/source.png. Example: https://example.com/source.png.
- `state` (`string`, optional): Custom state string. Returned as-is in the task result and webhook callback for your own tracking. Example: order-10423.

Example input: `{}`

### `cometapi_midjourney_imagine`

Create Midjourney Imagine Task · Write

Start a Midjourney (or Niji) image generation task from a text prompt, with optional reference images.
Returns code, description and result (the task ID).
Use this to create images with Midjourney. Poll cometapi_midjourney_task_get with the task ID, then use cometapi_midjourney_action for upscales and variations.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `prompt` (`string`, required): Text prompt for the generation. Supports standard Midjourney parameters such as --v, --ar, --stylize, etc. Example: a cat astronaut floating in space --ar 16:9 --v 7.
- `base64_array` (`array`, optional): Base64-encoded reference images. Each item should be a data URI such as data:image/png;base64,xxx. Example: ["data:image/png;base64,iVBORw0KGgo..."]
- `bot_type` (`string`, optional): Bot type to use. MID_JOURNEY for Midjourney (default), NIJI_JOURNEY for Niji. Example: MID_JOURNEY. One of: `MID_JOURNEY`, `NIJI_JOURNEY`.
- `state` (`string`, optional): Custom state string. Returned as-is in the task result and webhook callback for your own tracking. Example: order-10423.

Example input: `{"prompt":"[Verse]\\nA song about summer love and beach sunsets"}`

### `cometapi_minimax_video_create`

Create MiniMax Video Task · Write

Start a MiniMax Hailuo video generation task from a prompt and an optional first-frame image.
Returns task_id and base_resp.
Use this for MiniMax video models. Poll cometapi_minimax_video_get with the task_id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `model` (`string`, required): MiniMax video model id. minimax-hailuo-02 is the currently validated CometAPI example model. Defaults to minimax-hailuo-02. Example: minimax-hailuo-02.
- `prompt` (`string`, required): Prompt text. MiniMax allows long prompts, but short direct prompts are best for first-time integration tests. Example: A paper boat drifting down a rainy street.
- `duration` (`integer`, optional): Video length in seconds, such as 6. Example: 6.
- `first_frame_image` (`string`, optional): Optional first-frame image as a public URL or base64 data URI. Example: https://example.com/first-frame.jpg.
- `resolution` (`string`, optional): Output resolution tier, such as 768P. 512P is only available when first_frame_image is provided; text-only requests must use a higher tier. Example: 768P.

Example input: `{"model":"<model>","prompt":"[Verse]\\nA song about summer love and beach sunsets"}`

### `cometapi_moderation_create`

Create Moderation · Write

Check text (or text and images) for harmful content with an OpenAI-compatible moderation model.
Returns id, model and results, each with flagged, categories and category_scores.
Use this to screen user input or model output before using it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `input` (`array`, required): Content to check. Use a string for one text input, an array of strings for batch text checks, or OpenAI-style multimodal parts such as text plus image_url when the selected model supports it. Example: I want to hurt someone.
- `model` (`string`, required): Required moderation model ID. Use omni-moderation-latest for text and image moderation unless you have a specific moderation model requirement. Example: omni-moderation-latest.

Example input: `{"input":[],"model":"<model>"}`

### `cometapi_replicate_prediction_create`

Create Replicate Prediction · Write

Run a Replicate-hosted model (such as FLUX Schnell or FLUX Kontext) through CometAPI.
Returns the prediction with id, status and, when finished, output.
Use this for Replicate models. Poll cometapi_replicate_prediction_get with the id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `input` (`object`, required): Model-specific input object; every parameter of the model goes inside it, for example prompt and aspect_ratio. Example: {"prompt": "a cozy cabin in the woods", "aspect_ratio": "1:1"}
- `model` (`string`, required): Replicate model ID as owner/name, such as black-forest-labs/flux-schnell. Example: black-forest-labs/flux-schnell.

Example input: `{"input":{"prompt":"a cozy cabin in the woods","aspect_ratio":"1:1"},"model":"<model>"}`

### `cometapi_response_create`

Create Model Response · Write

Generate a model response with the OpenAI Responses API through CometAPI, with optional built-in tools such as web search, structured output and multi-turn state.
Returns the response object with id, status, output items (messages, reasoning and tool calls), output_text and usage.
Use this for OpenAI reasoning models and Responses features. Use cometapi_chat_completion_create for the Chat Completions format.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `input` (`array`, required): Text input as a string, or an array of input items (messages with text, image or file parts). Example: Write a haiku about autumn.
- `model` (`string`, required): Model ID to use. Get model IDs from cometapi_models_list. Defaults to gpt-6-astra. Example: gpt-4o-mini.
- `instructions` (`string`, optional): A system (or developer) message inserted into the model's context. When used with previous_response_id, instructions from the previous response are not carried over — this makes it easy to swap system messages between turns. Example: You are a concise assistant.
- `max_output_tokens` (`integer`, optional): An upper bound for the number of tokens that can be generated for a response, including visible output tokens and reasoning tokens. Example: 1024.
- `metadata` (`object`, optional): Set of up to 16 key-value pairs that can be attached to the response. Useful for storing additional information in a structured format. Keys have a maximum length of 64 characters; values have a maximum length of 512 characters. Example: {"order_id": "10423"}
- `previous_response_id` (`string`, optional): An ID for a stored response that is accessible to the selected model and request context. Cannot be combined with conversation. The conversation-history example sends prior input and output items explicitly. Example: resp_123.
- `reasoning` (`object`, optional): Reasoning configuration for the selected model. Example: {"effort": "low"}
- `service_tier` (`string`, optional): Specifies the processing tier for the request. When set, the response will include the actual service_tier used. - auto: Uses the tier configured in project settings (default behavior). - default: Standard pricing and performance. - flex: Flexible processing with potential cost savings. - priority: Priority processing with faster response times. Example: auto. One of: `auto`, `default`, `flex`, `priority`.
- `store` (`boolean`, optional): Request response storage for later retrieval, when supported by the selected model and request context. Example: false.
- `temperature` (`number`, optional): Sampling temperature. Omit this field for GPT-6 Astra. Example: 0.7.
- `text` (`object`, optional): Configuration for text output. Use this to request structured JSON output via JSON mode or JSON Schema. Example: {"format": {"type": "json_object"}}
- `tool_choice` (`string`, optional): Controls how the model selects which tool(s) to call. - auto (default): The model decides whether and which tools to call. - none: The model will not call any tools. - required: The model must call at least one tool. - An object specifying a particular tool to use. Example: auto.
- `tools` (`array`, optional): Tools available to the model. This page demonstrates web_search and custom function tools. Other tool types require their own configuration; see the official tool reference. Example: [{"type": "web_search"}]
- `top_p` (`number`, optional): Nucleus sampling threshold. Omit this field for GPT-6 Astra. For sampling overrides, adjust either top_p or temperature. Example: 1.
- `truncation` (`string`, optional): The truncation strategy for handling inputs that exceed the model's context window. - auto: The model truncates the input by dropping items from the beginning of the conversation to fit. - disabled (default): The request fails with a 400 error if the input exceeds the context window. Example: auto. One of: `auto`, `disabled`.

Example input: `{"input":[],"model":"<model>"}`

### `cometapi_runway_text_to_video`

Create Runway Text-to-Video Task · Write

Start a Runway video generation task from a text prompt (official Runway API format).
Returns the task id.
Use this for Runway text-to-video. Poll cometapi_runway_task_get with the id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `duration` (`integer`, required): Requested video duration in whole seconds, from 2 through 10. Example: 5.
- `model` (`string`, required): Model ID for this request variant. Example: gen4.5. One of: `gen4.5`.
- `prompt_text` (`string`, required): Describe the requested scene or motion in 1 to 1,000 UTF-16 code units. Example: A slow pan across a neon-lit city street in the rain.
- `ratio` (`string`, required): Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint. Example: 1280:720. One of: `1280:720`, `720:1280`.
- `content_moderation` (`object`, optional): Optional content moderation settings. Omit the object to use standard moderation. Example: {"publicFigureThreshold": "auto"}
- `seed` (`integer`, optional): Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed. Example: 42.

Example input: `{"duration":5,"model":"gen4.5","prompt_text":"<prompt_text>","ratio":"1280:720"}`

### `cometapi_sora_video_remix`

Remix Sora Video · Write

Start a Sora job that remixes a completed video with a new prompt.
Returns the new video job with id and status.
Use this to change an existing Sora video. Poll cometapi_video_job_get with the new id.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `prompt` (`string`, required): Describe the change you want to make to the existing video. Example: Make it night time with falling snow.
- `video_id` (`string`, required): ID of the completed source video. Example: video_68e688d4950481918ec389280c2f78140fcb904657674466.

Example input: `{"prompt":"[Verse]\\nA song about summer love and beach sunsets","video_id":"<video_id>"}`

### `cometapi_suno_lyrics_generate`

Generate Suno Lyrics · Write

Start a Suno task that writes song lyrics from a topic or description.
Returns code, message and data (the task ID); the finished task holds the title and lyrics.
Use this to draft lyrics for cometapi_suno_music_generate. Poll cometapi_suno_task_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `prompt` (`string`, required): Topic, theme, or description for lyrics generation. Can be a simple phrase, story concept, or specific instructions about what you want the lyrics to convey. - Example: "[Verse]\nA song about summer love and beach sunsets" - Example: "Write a romantic song about missing someone". Defaults to A song about summer love and beach sunsets.
- `notify_hook` (`string`, optional): Webhook URL for receiving lyrics generation completion notifications. When provided, the system sends a POST request with task results to this URL. - Must be a valid HTTP/HTTPS URL - Suitable for async processing and automated workflows. Defaults to https://your-server.example.com/webhook. Example: https://your-server.example.com/webhook.

Example input: `{"prompt":"[Verse]\\nA song about summer love and beach sunsets"}`

### `cometapi_suno_music_generate`

Generate Suno Music · Write

Start a Suno music generation task: a song from a description (inspiration mode), or from your own lyrics, style tags and title (custom mode), or an extension of an existing clip.
Returns code, message and data (the task ID).
Use this to create songs. Poll cometapi_suno_task_get with the task ID. Use cometapi_suno_lyrics_generate to write lyrics first.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `continue_at` (`string`, optional): Float. Position in seconds to continue from. Example: 120.5.
- `continue_clip_id` (`string`, optional): Clip ID of the song to extend. Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890.
- `gpt_description_prompt` (`string`, optional): Description of the song to write, for inspiration mode (leave prompt, tags and title empty). Example: an upbeat indie pop song about a summer road trip.
- `make_instrumental` (`boolean`, optional): Generate an instrumental track with no vocals. Defaults to true. Example: true.
- `mv` (`string`, optional): Suno model version. Use the model list to select an available version. Custom models use chirp-custom:{model_id}. Example: chirp-v4.
- `negative_tags` (`string`, optional): Excluded style tags. Defaults to heavy metal. Example: heavy metal.
- `notify_hook` (`string`, optional): Callback URL: https://example.com/callback. Example: https://example.com/callback.
- `prompt` (`string`, optional): Lyrics, for custom mode. Defaults to A gentle acoustic song about a paper boat at sunrise. Example: [Verse]
Paper boat at sunrise...
- `tags` (`string`, optional): Comma-separated style tags, for custom mode. Example: acoustic, folk, warm.
- `task` (`string`, optional): Selects a workflow such as vox, mashup_condition, chop_sample_condition, sound, playlist_condition, vox_playlist_condition, stem_condition, gen_stem, cover, or extend. Omit it for standard generation. Example: extend.
- `title` (`string`, optional): Song title, for custom mode. Example: Paper Boat.

Example input: `{}`

## Related

Other AI connectors ([all 216](/agentkit/connectors/?category=ai)):

- [Chorus](/agentkit/connectors/chorus/): Scalekit connector, Username and password, 9 tools
- [Gong](/agentkit/connectors/gong/): Scalekit connector, OAuth, 69 tools
- [Jiminny](/agentkit/connectors/jiminny/): Scalekit connector, Access token, 27 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
