@acedatacloud/sdk 2026.1101.0 → 2026.1101.1

package/README.md

@@ -71,8 +71,55 @@ for await (const chunk of stream) {
 | `client.files` | File uploads |
 | `client.platform` | Applications, credentials, models management |
 
+## Chat usage and billing
+
+Accepted model requests through Chat Completions, Responses, and Messages are
+billed by the selected model's input, output, and cache usage, not a fixed fee
+per request. Switching protocol formats does not change this to per-call billing
+or guarantee that a model accepts that format. Consult current model prices and
+`usage.cost` for the charge; the SDK preserves reported usage without recalculating it.
+
+- Chat Completions `prompt_tokens` includes reported cached tokens.
+- Responses `input_tokens` includes reported cached tokens.
+- Messages `input_tokens` excludes separately reported `cache_read_input_tokens`
+  and `cache_creation_input_tokens`; those dimensions are charged separately.
+
+Do not add cached tokens to the input total again for Chat Completions or
+Responses, or treat Messages input alone as the full input/cache usage.
+
+## Public Chat Completions models
+
+Pass these public IDs to `client.openai.chat.completions.create({ model, messages })`;
+use `stream: true` for streaming. The SDK passes model-specific fields through
+without rewriting model IDs or enforcing a catalog.
+
+- `gpt-6.1-terra`: supports text/image input, streaming, function tools, and
+  structured output. Use `reasoning_effort: 'low'` initially; supported levels are
+  `low`, `medium`, `high`, `xhigh`, and `max`, not `none` or `minimal`. Responses uses
+  `reasoning: { effort: 'low' }` instead. Inputs over 272,000 tokens use long-context
+  pricing; consult current prices and reported usage.
+- `claude-opus-5-5`: supports text and streaming Chat Completions with `n: 1`.
+  Omit `temperature` and `top_p` to use model defaults; do not set temperature below
+  1 or a non-default top-p. Use `tool_choice: 'auto'`, not forced tools. For native
+  thinking blocks, signatures, and native tool semantics, use `client.chat.messages`.
+- `gemini-4-argon`: supports text and streaming Chat Completions. Thinking can
+  consume output budget; Google recommends at least `max_tokens: 32768` for ordinary
+  tasks. This does not expose Interactions background long-output functionality.
+- `kimi-k3.1-pro`: always reasons; pass `reasoning_effort: 'low'`, `'high'`, or `'max'`.
+  Do not disable reasoning. Keep the full assistant message, including
+  `reasoning_content` and `tool_calls`, in multi-turn and tool-call history.
+  The existing `kimi-k3` alias remains available; use `reasoning_effort: 'max'` for it.
+
+Check current account access and prices before calling. A model's advertised
+context size does not guarantee the platform's per-request limit.
+
 ## Native Claude Messages
 
+For structured output, pass
+`output_config: { format: { type: 'json_schema', schema: yourSchema } }` to
+`client.chat.messages.create(...)`. Read the generated JSON from Messages `content`
+text blocks; this does not change the response envelope or increase `maxTokens`.
+
 Thinking and output configuration are passed through without SDK model-specific
 enum or combination checks. The selected model determines which values it accepts.
 For the beta `display: 'updates'` mode, set the required header on a dedicated
@@ -155,6 +202,14 @@ The public model ID also works with `client.openai.images.generate(...)` and
 `client.openai.images.edit(...)`; those use the OpenAI-compatible fields
 (`image` for editing) and return response objects, not task handles.
 
+### GPT Image 2.5 quality
+
+`client.openai.images.generate(...)` and `.edit(...)` pass `quality` through
+unchanged. GPT Image models accept `auto`, `low`, `medium`, and `high`;
+only `gpt-image-2.5-flare` and `gpt-image-2.5-sunburst` (including `:official`
+variants) additionally accept `xhigh` and `max`. Official-channel requests
+are billed by actual token usage, not a fixed fee per image.
+
 ## Maestro Video Production
 
 Use the provider client to request one finished video in one language:
@@ -181,8 +236,74 @@ with integer billed seconds capped at the requested duration (falling back to
 that duration if it cannot be read). All scenarios, actions, and languages have
 the same rate; failed tasks and `/maestro/tasks` polling are free.
 
+`style` accepts a freeform visual hint as well as named presets. `voice` accepts
+named voice presets or a 32-character hexadecimal voice `reference_id`; pass it unchanged.
+
+## Producer action-specific inputs
+
+`await client.producer.generate({ action: 'generate', prompt: 'A jazz song' })`
+uses inspiration mode (`custom: false` by default). For custom vocals, set
+`custom: true` and provide `lyric`; for custom instrumental music, set
+`custom: true, instrumental: true` without inventing lyrics or a prompt.
+Extensions require `audioId`, positive `continueAt` (seconds, including fractions),
+and `lyric` unless instrumental. Covers, variations, section replacement,
+vocal/instrument swaps, and stems require the source `audioId`. `lyric` and `prompt`
+are no longer required for every action; generation still returns a task handle.
+
+## WebExtrator navigation and cache
+
+`client.webextrator.extract(...)` and `.render(...)` accept `cookies`,
+`bypassCache`, and `cacheTtlSeconds`, mapped to the API's snake_case cache fields.
+Each cookie requires `name`, `value`, and `domain`; optional fields are `path`,
+`expires` (Unix seconds), `httpOnly`, `secure`, and `sameSite` (`Strict`, `Lax`,
+or `None`). Keep cookie values out of logs and Git.
+
+The server defaults `waitUntil` to `load`, navigation `timeout` to 30 seconds,
+and cache TTL to 3600 seconds. `timeout` must be a positive integer; `delay` and
+`cacheTtlSeconds` must be nonnegative integers. `bypassCache: true` skips cache
+reads but can still cache the fresh result; `cacheTtlSeconds: 0` disables caching
+that result. Omitted options remain omitted.
+
+## Kling reference-video billing
+
+Pass `videoList: [{ videoUrl: referenceUrl, referType: 'feature' }]`
+to `client.kling.generate` with `model: 'kling-o1'` or `'kling-v3-omni'`.
+Reference videos use a separate billing tier: **1.202 Credits/second** in `std`
+mode and **1.602 Credits/second** in `pro` mode. For a 5-second O1 result,
+`std` / `pro` cost **4.005 / 5.340 Credits** without a reference video, or
+**6.010 / 8.010 Credits** with one.
+
+`referType: 'base'` (the default) edits may follow the reference video's length;
+billing uses the actual output duration rounded to the nearest integer second.
+`referType: 'feature'` uses the requested `duration`. Read
+`response.usage.reference_video_seconds` for the final billed seconds;
+the request-time estimate can differ from the final charge. This is response
+usage, not a request parameter. Image references and first/last frames alone do
+not trigger reference-video billing. Do not combine `videoList` with
+`generateAudio: true`.
+
 ## Suno music processing
 
+For a private voice created by `client.suno.voices(...)`, upload the original
+song with `await client.suno.upload({ audioUrl: sourceUrl, personaId })`.
+This field is supported only for standard uploads (the default), not
+`mode: 'enhanced'`. After upload succeeds, use the returned `data.audio_id` as
+`audioId` and the same `personaId` in
+`await client.suno.generate({ action: 'upload_cover', audioId, personaId })`.
+Do not reuse a song ID uploaded without that voice association. Voice creation,
+upload, and cover must use the same service channel. `vocalGender` is not
+required and cannot replace `personaId`.
+
+Before a cover or extension, optionally call
+`await client.suno.availability({ audioId })`. Use the song's `audio_id` from a
+completed task, not its `task_id`. This is a synchronous API-token-authenticated
+check, currently without a Credits charge; it returns the response object
+directly, not a task handle to poll. `result.data.available` is only `true` on
+success: it is positive evidence on the current channel, not a guarantee that
+a subsequent operation will work. An inconclusive check returns an error,
+including `503 availability_unknown`; never convert an error into `false`.
+Preserve the error code and trace ID.
+
 Use `client.suno.generate({ custom: true, lyric, style, negativeTags })` for
 custom-mode music. `negativeTags` describes styles or genres to exclude; there
 is currently no fixed character limit, but overly long input may still fail,
@@ -194,6 +315,9 @@ for covers, extensions or stem separation. If processing returns
 `id`, when available) and the error's `traceId` for support. The related codes
 `suno_model_unavailable` and `suno_processing_failed` mean the selected model is
 unavailable for that operation or processing returned no audio, respectively.
+Suno can also return `api_error` with the message
+`the account may have been offline`; this is a server error, not an SDK
+authentication error.
 These HTTP 500 errors retain their `code`, `traceId` and `body` on `APIError`.
 Retrieve an existing task rather than submitting a replacement generation just
 to check its result.
@@ -282,6 +406,13 @@ const client = new AceDataCloud({
 
 The token can also be set via the `ACEDATACLOUD_API_TOKEN` environment variable.
 
+`await client.platform.config.get()` returns `features` and `region`. `region`
+is the lowercase country/region code detected from the request IP, or `null`
+when unknown. The endpoint accepts no country/region override. Keep any
+user-selected display region in your own application; it does not change
+server-side availability or security policies. Feature keys may change; use
+safe defaults for missing keys and do not share cached config across users.
+
 ## Paying with X402 Instead of a Bearer Token
 
 The SDK supports a pluggable `paymentHandler` that is invoked when the

package/dist/index.d.mts

@@ -131,7 +131,7 @@ declare class Transport {
 
 /** AI Chat resources — aichat/conversations endpoint. */
 
-type AiChatModel = 'mimo-v2.6-pro' | 'mimo-v2.6-flash' | 'gpt-5.6-sol-fast' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-5.4' | 'gpt-5.4-pro' | 'gpt-5.2' | 'gpt-5.1' | 'gpt-5.1-all' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-all' | 'gpt-4' | 'gpt-4-all' | 'gpt-4-turbo' | 'gpt-4-turbo-preview' | 'gpt-4-vision-preview' | 'gpt-4.1' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4.5-preview' | 'gpt-4.5-preview-2025-02-27' | 'gpt-4o' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-all' | 'gpt-4o-image' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini-search-preview' | 'gpt-4o-mini-search-preview-2025-03-11' | 'gpt-4o-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'o1' | 'o1-2024-12-17' | 'o1-all' | 'o1-mini' | 'o1-mini-2024-09-12' | 'o1-mini-all' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-preview-all' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o1-pro-all' | 'o3' | 'o3-2025-04-16' | 'o3-all' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o3-mini-2025-01-31-high' | 'o3-mini-2025-01-31-low' | 'o3-mini-2025-01-31-medium' | 'o3-mini-all' | 'o3-mini-high' | 'o3-mini-high-all' | 'o3-mini-low' | 'o3-mini-medium' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o4-mini-all' | 'o4-mini-high-all' | 'deepseek-r1' | 'deepseek-r1-0528' | 'deepseek-v3' | 'deepseek-v3-250324' | 'deepseek-v4-flash' | 'grok-3' | 'glm-5.1' | 'glm-4.7' | 'glm-4.6' | 'glm-3-turbo' | (string & {});
+type AiChatModel = 'mimo-v2.6-pro' | 'mimo-v2.6-flash' | 'gpt-6.1-terra' | 'gpt-5.6-sol-fast' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-5.4' | 'gpt-5.4-pro' | 'gpt-5.2' | 'gpt-5.1' | 'gpt-5.1-all' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-all' | 'gpt-4' | 'gpt-4-all' | 'gpt-4-turbo' | 'gpt-4-turbo-preview' | 'gpt-4-vision-preview' | 'gpt-4.1' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4.5-preview' | 'gpt-4.5-preview-2025-02-27' | 'gpt-4o' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-all' | 'gpt-4o-image' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini-search-preview' | 'gpt-4o-mini-search-preview-2025-03-11' | 'gpt-4o-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'o1' | 'o1-2024-12-17' | 'o1-all' | 'o1-mini' | 'o1-mini-2024-09-12' | 'o1-mini-all' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-preview-all' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o1-pro-all' | 'o3' | 'o3-2025-04-16' | 'o3-all' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o3-mini-2025-01-31-high' | 'o3-mini-2025-01-31-low' | 'o3-mini-2025-01-31-medium' | 'o3-mini-all' | 'o3-mini-high' | 'o3-mini-high-all' | 'o3-mini-low' | 'o3-mini-medium' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o4-mini-all' | 'o4-mini-high-all' | 'deepseek-r1' | 'deepseek-r1-0528' | 'deepseek-v3' | 'deepseek-v3-250324' | 'deepseek-v4-flash' | 'grok-3' | 'glm-5.1' | 'glm-4.7' | 'glm-4.6' | 'glm-3-turbo' | (string & {});
 declare class AiChat {
     private transport;
     constructor(transport: Transport);
@@ -693,6 +693,16 @@ declare class Kling {
 
 /** WebExtrator web render & extract resources. */
 
+interface WebExtratorCookie {
+    name: string;
+    value: string;
+    domain: string;
+    path?: string;
+    expires?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
 declare class WebExtrator {
     private transport;
     constructor(transport: Transport);
@@ -709,6 +719,9 @@ declare class WebExtrator {
         userAgent?: string;
         callbackUrl?: string;
         async?: boolean;
+        cookies?: WebExtratorCookie[];
+        bypassCache?: boolean;
+        cacheTtlSeconds?: number;
         [key: string]: unknown;
     }): Promise<Record<string, unknown>>;
     render(opts: {
@@ -722,6 +735,9 @@ declare class WebExtrator {
         userAgent?: string;
         callbackUrl?: string;
         async?: boolean;
+        cookies?: WebExtratorCookie[];
+        bypassCache?: boolean;
+        cacheTtlSeconds?: number;
         [key: string]: unknown;
     }): Promise<Record<string, unknown>>;
 }

package/dist/index.d.ts

@@ -131,7 +131,7 @@ declare class Transport {
 
 /** AI Chat resources — aichat/conversations endpoint. */
 
-type AiChatModel = 'mimo-v2.6-pro' | 'mimo-v2.6-flash' | 'gpt-5.6-sol-fast' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-5.4' | 'gpt-5.4-pro' | 'gpt-5.2' | 'gpt-5.1' | 'gpt-5.1-all' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-all' | 'gpt-4' | 'gpt-4-all' | 'gpt-4-turbo' | 'gpt-4-turbo-preview' | 'gpt-4-vision-preview' | 'gpt-4.1' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4.5-preview' | 'gpt-4.5-preview-2025-02-27' | 'gpt-4o' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-all' | 'gpt-4o-image' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini-search-preview' | 'gpt-4o-mini-search-preview-2025-03-11' | 'gpt-4o-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'o1' | 'o1-2024-12-17' | 'o1-all' | 'o1-mini' | 'o1-mini-2024-09-12' | 'o1-mini-all' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-preview-all' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o1-pro-all' | 'o3' | 'o3-2025-04-16' | 'o3-all' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o3-mini-2025-01-31-high' | 'o3-mini-2025-01-31-low' | 'o3-mini-2025-01-31-medium' | 'o3-mini-all' | 'o3-mini-high' | 'o3-mini-high-all' | 'o3-mini-low' | 'o3-mini-medium' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o4-mini-all' | 'o4-mini-high-all' | 'deepseek-r1' | 'deepseek-r1-0528' | 'deepseek-v3' | 'deepseek-v3-250324' | 'deepseek-v4-flash' | 'grok-3' | 'glm-5.1' | 'glm-4.7' | 'glm-4.6' | 'glm-3-turbo' | (string & {});
+type AiChatModel = 'mimo-v2.6-pro' | 'mimo-v2.6-flash' | 'gpt-6.1-terra' | 'gpt-5.6-sol-fast' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-5.4' | 'gpt-5.4-pro' | 'gpt-5.2' | 'gpt-5.1' | 'gpt-5.1-all' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-all' | 'gpt-4' | 'gpt-4-all' | 'gpt-4-turbo' | 'gpt-4-turbo-preview' | 'gpt-4-vision-preview' | 'gpt-4.1' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4.5-preview' | 'gpt-4.5-preview-2025-02-27' | 'gpt-4o' | 'gpt-4o-2024-05-13' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-11-20' | 'gpt-4o-all' | 'gpt-4o-image' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-mini-search-preview' | 'gpt-4o-mini-search-preview-2025-03-11' | 'gpt-4o-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'o1' | 'o1-2024-12-17' | 'o1-all' | 'o1-mini' | 'o1-mini-2024-09-12' | 'o1-mini-all' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-preview-all' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o1-pro-all' | 'o3' | 'o3-2025-04-16' | 'o3-all' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o3-mini-2025-01-31-high' | 'o3-mini-2025-01-31-low' | 'o3-mini-2025-01-31-medium' | 'o3-mini-all' | 'o3-mini-high' | 'o3-mini-high-all' | 'o3-mini-low' | 'o3-mini-medium' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o4-mini-all' | 'o4-mini-high-all' | 'deepseek-r1' | 'deepseek-r1-0528' | 'deepseek-v3' | 'deepseek-v3-250324' | 'deepseek-v4-flash' | 'grok-3' | 'glm-5.1' | 'glm-4.7' | 'glm-4.6' | 'glm-3-turbo' | (string & {});
 declare class AiChat {
     private transport;
     constructor(transport: Transport);
@@ -693,6 +693,16 @@ declare class Kling {
 
 /** WebExtrator web render & extract resources. */
 
+interface WebExtratorCookie {
+    name: string;
+    value: string;
+    domain: string;
+    path?: string;
+    expires?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
 declare class WebExtrator {
     private transport;
     constructor(transport: Transport);
@@ -709,6 +719,9 @@ declare class WebExtrator {
         userAgent?: string;
         callbackUrl?: string;
         async?: boolean;
+        cookies?: WebExtratorCookie[];
+        bypassCache?: boolean;
+        cacheTtlSeconds?: number;
         [key: string]: unknown;
     }): Promise<Record<string, unknown>>;
     render(opts: {
@@ -722,6 +735,9 @@ declare class WebExtrator {
         userAgent?: string;
         callbackUrl?: string;
         async?: boolean;
+        cookies?: WebExtratorCookie[];
+        bypassCache?: boolean;
+        cacheTtlSeconds?: number;
         [key: string]: unknown;
     }): Promise<Record<string, unknown>>;
 }

package/dist/index.js

@@ -1408,7 +1408,7 @@ var WebExtrator = class {
   }
   transport;
   async extract(opts) {
-    const { url, expectedType, enableLlm, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, ...rest } = opts;
+    const { url, expectedType, enableLlm, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, cookies, bypassCache, cacheTtlSeconds, ...rest } = opts;
     const body = { url, ...rest };
     if (expectedType !== void 0) body.expected_type = expectedType;
     if (enableLlm !== void 0) body.enable_llm = enableLlm;
@@ -1420,10 +1420,13 @@ var WebExtrator = class {
     if (headers !== void 0) body.headers = headers;
     if (userAgent !== void 0) body.user_agent = userAgent;
     if (callbackUrl !== void 0) body.callback_url = callbackUrl;
+    if (cookies !== void 0) body.cookies = cookies;
+    if (bypassCache !== void 0) body.bypass_cache = bypassCache;
+    if (cacheTtlSeconds !== void 0) body.cache_ttl_seconds = cacheTtlSeconds;
     return this.transport.request("POST", "/webextrator/extract", { json: body });
   }
   async render(opts) {
-    const { url, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, ...rest } = opts;
+    const { url, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, cookies, bypassCache, cacheTtlSeconds, ...rest } = opts;
     const body = { url, ...rest };
     if (waitUntil !== void 0) body.wait_until = waitUntil;
     if (timeout !== void 0) body.timeout = timeout;
@@ -1433,6 +1436,9 @@ var WebExtrator = class {
     if (headers !== void 0) body.headers = headers;
     if (userAgent !== void 0) body.user_agent = userAgent;
     if (callbackUrl !== void 0) body.callback_url = callbackUrl;
+    if (cookies !== void 0) body.cookies = cookies;
+    if (bypassCache !== void 0) body.bypass_cache = bypassCache;
+    if (cacheTtlSeconds !== void 0) body.cache_ttl_seconds = cacheTtlSeconds;
     return this.transport.request("POST", "/webextrator/render", { json: body });
   }
 };
@@ -2034,13 +2040,13 @@ var Producer = class {
   /** Producer AI music generation API, generates 1 song per request. */
   async generate(options) {
     const body = {};
-    body["lyric"] = options.lyric;
     body["action"] = options.action;
-    body["prompt"] = options.prompt;
     if (options.seed !== void 0) body["seed"] = options.seed;
+    if (options.lyric !== void 0) body["lyric"] = options.lyric;
     if (options.model !== void 0) body["model"] = options.model;
     if (options.title !== void 0) body["title"] = options.title;
-    if (options.custom !== void 0) body["custom"] = options.custom;
+    body["custom"] = options.custom ?? false;
+    if (options.prompt !== void 0) body["prompt"] = options.prompt;
     if (options.audioId !== void 0) body["audio_id"] = options.audioId;
     body["weirdness"] = options.weirdness ?? false;
     body["continue_at"] = options.continueAt ?? false;
@@ -2423,8 +2429,9 @@ var Suno = class {
   async upload(options) {
     const body = {};
     body["audio_url"] = options.audioUrl;
+    if (options.personaId !== void 0) body["persona_id"] = options.personaId;
     for (const [key, value] of Object.entries(options)) {
-      if (!["async", "audioUrl", "callbackUrl", "maxWait", "pollInterval", "wait"].includes(key) && value !== void 0) {
+      if (!["async", "audioUrl", "callbackUrl", "maxWait", "personaId", "pollInterval", "wait"].includes(key) && value !== void 0) {
         body[key] = value;
       }
     }
@@ -2449,6 +2456,18 @@ var Suno = class {
     }
     return handle;
   }
+  /** Check Suno audio availability. */
+  async availability(options) {
+    const body = {};
+    body["audio_id"] = options.audioId;
+    for (const [key, value] of Object.entries(options)) {
+      if (!["async", "audioId", "callbackUrl", "maxWait", "pollInterval", "wait"].includes(key) && value !== void 0) {
+        body[key] = value;
+      }
+    }
+    if (options.callbackUrl !== void 0) body.callback_url = options.callbackUrl;
+    return await this.transport.request("POST", "/suno/availability", { json: body });
+  }
 };
 
 // src/resources/providers/wan.ts