@neta-art/generation 0.1.1 → 0.1.3

package/README.md

@@ -60,12 +60,49 @@ pnpm example:image-editing
 pnpm example:text-to-video
 ```
 
+You can also call providers through the CLI:
+
+```bash
+node --env-file=.env ./dist/cli/index.js generate gemini-3.1-flash-image-preview \
+  --prompt "a simple abstract geometric app icon" \
+  --param aspect_ratio=1:1 \
+  --param image_size=512 \
+  --debug
+```
+
+Use `--image-url` for reference images, `--out` to write base64 outputs to files, and `json:` for non-string parameter values, for example `--param duration=json:5`.
+
+## Debug provider requests
+
+Pass `debug: true` to print the final provider request and response metadata to stderr. Sensitive fields such as `Authorization` and base64 image data are redacted by default.
+
+```ts
+const client = createGenerationClient({
+  apiKey: process.env.NETA_ROUTER_API_KEY!,
+  debug: true,
+});
+```
+
+For a custom logger or full unredacted payloads:
+
+```ts
+const client = createGenerationClient({
+  apiKey: process.env.NETA_ROUTER_API_KEY!,
+  debug: {
+    enabled: true,
+    includeSensitive: true,
+    logger: (event) => console.error(JSON.stringify(event, null, 2)),
+  },
+});
+```
+
 ## Built-in models
 
 - `gpt-image-2`
 - `gemini-3.1-flash-image-preview`
 - `seedance-2-0`
 - `seedance-2-0-fast`
+- `suno_music`
 
 Built-in model declarations share the same client-level `apiKey` and `baseUrl`.
 
@@ -114,6 +151,37 @@ await client.generate({
 });
 ```
 
+## Music generation
+
+```ts
+const output = await client.generate({
+  model: "suno_music",
+  content: [
+    { type: "text", text: "uplifting cinematic pop with warm piano and clear chorus" },
+  ],
+  parameters: {
+    operation: "music",
+  },
+  meta: {
+    mv: "chirp-v5-5",
+    title: "Warm Horizon",
+    tags: "cinematic pop, warm piano",
+    make_instrumental: false,
+  },
+});
+
+console.log(output);
+```
+
+Suno uses one public model, `suno_music`. SDK-level parameters control execution:
+
+- `music`
+- `lyrics`
+
+Provider-specific Suno fields belong in `meta`, not `parameters`. The adapter passes `meta` through to Suno and defaults
+`meta.mv` to `chirp-v5-5` for music requests. Use `meta.task` for Yunwu-style integrated tasks such as `sound`, `cover`,
+`image_to_song`, `video_to_song`, `remaster`, `underpainting`, or `mashup_condition`.
+
 ## Load model declarations from files
 
 ```ts
@@ -193,6 +261,7 @@ Built-in adapters:
 - `openai.images`
 - `gemini.generateContent`
 - `ark.videoGenerations`
+- `suno.tasks`
 
 You can register custom adapters:
 

package/dist/{builtins-BuI-rf8X.d.ts → builtins-BJ2_TVlr.d.ts}

@@ -66,11 +66,28 @@ type GenerationParameterSpec = {
   description?: string;
   examples?: boolean[];
 };
+type GenerationMetaFieldSpec = GenerationParameterSpec | {
+  type: "object";
+  optional?: boolean;
+  description?: string;
+};
+type GenerationMetaTaskVariantSpec = {
+  description?: string;
+  required?: string[];
+  requiredContent?: Array<GenerationContentSpec["type"]>;
+  sendTask?: boolean;
+};
+type GenerationMetaSpec = {
+  fields?: Record<string, GenerationMetaFieldSpec>;
+  taskField?: string;
+  taskVariants?: Record<string, GenerationMetaTaskVariantSpec>;
+};
 type GenerationModelDeclaration = {
   schema: typeof MODEL_SCHEMA;
   model: string;
   title?: string;
   description?: string;
+  allowUnknownParameters?: boolean;
   adapter: {
     type: string;
   };
@@ -78,6 +95,7 @@ type GenerationModelDeclaration = {
     input: GenerationContentSpec[];
   };
   parameters?: Record<string, GenerationParameterSpec>;
+  meta?: GenerationMetaSpec;
   examples?: Array<{
     title?: string;
     request: GenerateRequest;
@@ -87,16 +105,48 @@ type GenerateRequest = {
   model: string;
   content: GenerationContentBlock[];
   parameters?: Record<string, unknown>;
+  meta?: Record<string, unknown>;
+  /** @deprecated Use meta. */
+  metadata?: Record<string, unknown>;
   apiKey?: string;
   baseUrl?: string;
-  metadata?: Record<string, unknown>;
 };
 type ResolvedGenerationRequest = {
   declaration: GenerationModelDeclaration;
   request: GenerateRequest;
   parameters: Record<string, unknown>;
+  meta: Record<string, unknown>;
 };
 type GenerationSourceResolver = (source: GenerationSource) => Promise<string> | string;
+type GenerationDebugEvent = {
+  type: "request";
+  url: string;
+  method: string;
+  headers: Record<string, string>;
+  body?: unknown;
+} | {
+  type: "response";
+  url: string;
+  status: number;
+  statusText: string;
+  headers: Record<string, string>;
+  trace: Record<string, string>;
+  elapsedMs: number;
+  body?: unknown;
+};
+type GenerationDebugLogger = (event: GenerationDebugEvent) => void;
+type GenerationDebugOptions = {
+  enabled?: boolean;
+  includeSensitive?: boolean;
+  includeResponseBody?: boolean;
+  logger?: GenerationDebugLogger;
+};
+type GenerationDebugConfig = GenerationDebugOptions & {
+  enabled: boolean;
+  includeSensitive: boolean;
+  includeResponseBody: boolean;
+  logger: GenerationDebugLogger;
+};
 type GenerationAdapterContext = {
   apiKey: string;
   baseUrl: string;
@@ -115,6 +165,7 @@ type CreateGenerationClientOptions = {
   fetch?: typeof fetch;
   sourceResolver?: GenerationSourceResolver;
   adapters?: Record<string, GenerationAdapter>;
+  debug?: boolean | GenerationDebugOptions;
 };
 type GenerationClient = {
   generate(request: GenerateRequest): Promise<GenerationContentBlock[]>;
@@ -133,5 +184,5 @@ declare const builtinGenerationModels: GenerationModelDeclaration[];
 declare function getBuiltinGenerationModel(model: string): GenerationModelDeclaration | null;
 declare function listBuiltinGenerationModels(): GenerationModelDeclaration[];
 //#endregion
-export { MODEL_SCHEMA as _, GenerateRequest as a, GenerationAdapterInput as c, GenerationContentBlockMeta as d, GenerationContentSpec as f, GenerationSourceResolver as g, GenerationSource as h, CreateGenerationClientOptions as i, GenerationClient as l, GenerationParameterSpec as m, getBuiltinGenerationModel as n, GenerationAdapter as o, GenerationModelDeclaration as p, listBuiltinGenerationModels as r, GenerationAdapterContext as s, builtinGenerationModels as t, GenerationContentBlock as u, ResolvedGenerationRequest as v };
-//# sourceMappingURL=builtins-BuI-rf8X.d.ts.map
+export { GenerationSourceResolver as C, GenerationSource as S, ResolvedGenerationRequest as T, GenerationMetaFieldSpec as _, GenerateRequest as a, GenerationModelDeclaration as b, GenerationAdapterInput as c, GenerationContentBlockMeta as d, GenerationContentSpec as f, GenerationDebugOptions as g, GenerationDebugLogger as h, CreateGenerationClientOptions as i, GenerationClient as l, GenerationDebugEvent as m, getBuiltinGenerationModel as n, GenerationAdapter as o, GenerationDebugConfig as p, listBuiltinGenerationModels as r, GenerationAdapterContext as s, builtinGenerationModels as t, GenerationContentBlock as u, GenerationMetaSpec as v, MODEL_SCHEMA as w, GenerationParameterSpec as x, GenerationMetaTaskVariantSpec as y };
+//# sourceMappingURL=builtins-BJ2_TVlr.d.ts.map

package/dist/builtins-BJ2_TVlr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins-BJ2_TVlr.d.ts","names":[],"sources":["../src/types.ts","../src/builtins.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/{builtins-B1AheaEa.js → builtins-FumzmWvj.js}

@@ -146,6 +146,116 @@ function videoParameters(defaults) {
 		}
 	};
 }
+const sunoContinuationTaskVariant = { required: [
+	"task_id",
+	"clip_id",
+	"continue_clip_id"
+] };
+const sunoMeta = {
+	taskField: "task",
+	fields: {
+		task: {
+			type: "string",
+			optional: true,
+			enum: [
+				"extend",
+				"upload_extend",
+				"infill",
+				"fixed_infill",
+				"infill_intro",
+				"infill_outro",
+				"cover_infill",
+				"cover_extend",
+				"artist_infill",
+				"artist_consistency",
+				"cover",
+				"image_to_song",
+				"video_to_song",
+				"concat",
+				"sound",
+				"underpainting",
+				"remaster",
+				"vox",
+				"mashup_condition"
+			],
+			description: "Integrated Suno music task for operation=music."
+		},
+		mv: {
+			type: "string",
+			optional: true,
+			description: "Suno music model version."
+		},
+		task_id: {
+			type: "string",
+			optional: true,
+			description: "Existing Suno task id used for continuation-style tasks."
+		},
+		clip_id: {
+			type: "string",
+			optional: true,
+			description: "Existing Suno clip id used for continuation-style tasks."
+		},
+		continue_clip_id: {
+			type: "string",
+			optional: true,
+			description: "Clip id to continue from."
+		},
+		continue_at: {
+			type: "number",
+			optional: true,
+			description: "Continue position in seconds."
+		},
+		model_name: {
+			type: "string",
+			optional: true,
+			description: "Suno model name used by remaster."
+		},
+		variation_category: {
+			type: "string",
+			optional: true,
+			description: "Remaster variation category."
+		},
+		metadata_params: {
+			type: "object",
+			optional: true,
+			description: "Yunwu/Suno task-specific metadata payload."
+		}
+	},
+	taskVariants: {
+		extend: sunoContinuationTaskVariant,
+		upload_extend: sunoContinuationTaskVariant,
+		infill: sunoContinuationTaskVariant,
+		fixed_infill: sunoContinuationTaskVariant,
+		infill_intro: sunoContinuationTaskVariant,
+		infill_outro: sunoContinuationTaskVariant,
+		cover_infill: sunoContinuationTaskVariant,
+		cover_extend: sunoContinuationTaskVariant,
+		artist_infill: sunoContinuationTaskVariant,
+		artist_consistency: sunoContinuationTaskVariant,
+		cover: sunoContinuationTaskVariant,
+		image_to_song: {
+			requiredContent: ["image"],
+			required: ["metadata_params"]
+		},
+		video_to_song: {
+			requiredContent: ["video"],
+			required: ["metadata_params"]
+		},
+		concat: sunoContinuationTaskVariant,
+		sound: { required: ["metadata_params"] },
+		underpainting: { required: ["metadata_params"] },
+		remaster: {
+			sendTask: false,
+			required: [
+				"clip_id",
+				"model_name",
+				"variation_category"
+			]
+		},
+		vox: sunoContinuationTaskVariant,
+		mashup_condition: sunoContinuationTaskVariant
+	}
+};
 const builtinModels = [
 	{
 		schema: MODEL_SCHEMA,
@@ -303,6 +413,143 @@ const builtinModels = [
 			resolution: "720p",
 			maxWait: 600
 		})
+	},
+	{
+		schema: MODEL_SCHEMA,
+		model: "suno_music",
+		title: "Suno Music",
+		description: "Suno music model for songs, lyrics, sound effects, and integrated music tasks.",
+		adapter: { type: "suno.tasks" },
+		content: { input: [
+			{
+				type: "text",
+				required: false,
+				max: 16,
+				merge: "newline",
+				description: "Optional prompt text. The adapter maps merged text to the operation's text field when that field is not provided."
+			},
+			{
+				type: "audio",
+				required: false,
+				max: 1,
+				sources: ["url", "base64"],
+				description: "Optional reference audio. The adapter maps it to url when url is not provided."
+			},
+			{
+				type: "image",
+				required: false,
+				max: 1,
+				sources: ["url", "base64"],
+				description: "Optional image source. The adapter maps it to image_url when image_url is not provided."
+			},
+			{
+				type: "video",
+				required: false,
+				max: 1,
+				sources: ["url", "base64"],
+				description: "Optional video source. The adapter maps it to video_url when video_url is not provided."
+			}
+		] },
+		parameters: {
+			operation: {
+				type: "string",
+				optional: true,
+				default: "music",
+				enum: ["music", "lyrics"],
+				description: "Stable Suno endpoint operation. Provider-specific fields such as task, mv, title, tags, metadataParams, and clip_id belong in request meta."
+			},
+			poll_interval: {
+				type: "integer",
+				optional: true,
+				default: 5,
+				min: 1,
+				max: 60,
+				description: "Seconds between task status checks."
+			},
+			max_wait: {
+				type: "integer",
+				optional: true,
+				default: 600,
+				min: 30,
+				max: 3600,
+				description: "Maximum seconds to wait for task completion."
+			}
+		},
+		meta: sunoMeta,
+		examples: [
+			{
+				title: "Music generation",
+				request: {
+					model: "suno_music",
+					content: [{
+						type: "text",
+						text: "uplifting cinematic pop with warm piano and clear chorus"
+					}],
+					parameters: { operation: "music" },
+					meta: {
+						mv: "chirp-v5-5",
+						title: "Warm Horizon",
+						tags: "cinematic pop, warm piano",
+						make_instrumental: false
+					}
+				}
+			},
+			{
+				title: "Lyrics",
+				request: {
+					model: "suno_music",
+					content: [{
+						type: "text",
+						text: "write a hopeful chorus about sunrise after a storm"
+					}],
+					parameters: { operation: "lyrics" }
+				}
+			},
+			{
+				title: "Sound effect",
+				request: {
+					model: "suno_music",
+					content: [{
+						type: "text",
+						text: "ambient music with gentle rain and distant thunder"
+					}],
+					parameters: { operation: "music" },
+					meta: {
+						task: "sound",
+						mv: "chirp-v5-5",
+						metadata_params: { sound: "gentle rain ambience with distant thunder" },
+						title: "Gentle Rain",
+						tags: "ambient, rain, cinematic",
+						make_instrumental: true
+					}
+				}
+			},
+			{
+				title: "Image to song",
+				request: {
+					model: "suno_music",
+					content: [{
+						type: "text",
+						text: "turn this image into a short hopeful pop song"
+					}, {
+						type: "image",
+						source: {
+							type: "url",
+							url: "https://picsum.photos/512/512"
+						}
+					}],
+					parameters: { operation: "music" },
+					meta: {
+						task: "image_to_song",
+						mv: "chirp-v5-5",
+						metadata_params: {
+							image_url: "https://picsum.photos/512/512",
+							prompt: "turn this image into a short hopeful pop song"
+						}
+					}
+				}
+			}
+		]
 	}
 ];
 const builtinGenerationModels = cloneJson(builtinModels);
@@ -315,4 +562,4 @@ function listBuiltinGenerationModels() {
 
 //#endregion
 export { compactArray as a, slugifyFileName as c, cloneJson as i, MODEL_SCHEMA as l, getBuiltinGenerationModel as n, compactObject as o, listBuiltinGenerationModels as r, getBlockMeta as s, builtinGenerationModels as t };
-//# sourceMappingURL=builtins-B1AheaEa.js.map
+//# sourceMappingURL=builtins-FumzmWvj.js.map

package/dist/builtins-FumzmWvj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins-FumzmWvj.js","names":["builtinGenerationModels: GenerationModelDeclaration[]"],"sources":["../src/types.ts","../src/utils.ts","../src/builtins.ts"],"sourcesContent":["export const MODEL_SCHEMA = \"neta.generation.model.v1\" as const;\n\nexport type GenerationSource = { type: \"url\"; url: string } | { type: \"base64\"; mediaType: string; data: string };\n\nexport type GenerationContentBlockMeta = Record<string, unknown>;\n\nexport type GenerationContentBlock =\n  | { type: \"text\"; text: string; meta?: GenerationContentBlockMeta }\n  | { type: \"image\"; source: GenerationSource; meta?: GenerationContentBlockMeta }\n  | { type: \"video\"; source: GenerationSource; meta?: GenerationContentBlockMeta }\n  | { type: \"audio\"; source: GenerationSource; meta?: GenerationContentBlockMeta };\n\nexport type GenerationContentSpec = {\n  type: \"text\" | \"image\" | \"video\" | \"audio\";\n  required?: boolean;\n  min?: number;\n  max?: number;\n  sources?: Array<GenerationSource[\"type\"]>;\n  merge?: \"newline\" | \"space\" | \"concat\";\n  meta?: Record<string, unknown>;\n  description?: string;\n};\n\nexport type GenerationParameterSpec =\n  | {\n      type: \"string\";\n      optional?: boolean;\n      default?: string;\n      enum?: string[];\n      description?: string;\n      examples?: string[];\n    }\n  | {\n      type: \"number\";\n      optional?: boolean;\n      default?: number;\n      min?: number;\n      max?: number;\n      description?: string;\n      examples?: number[];\n    }\n  | {\n      type: \"integer\";\n      optional?: boolean;\n      default?: number;\n      min?: number;\n      max?: number;\n      description?: string;\n      examples?: number[];\n    }\n  | {\n      type: \"boolean\";\n      optional?: boolean;\n      default?: boolean;\n      description?: string;\n      examples?: boolean[];\n    };\n\nexport type GenerationMetaFieldSpec =\n  | GenerationParameterSpec\n  | { type: \"object\"; optional?: boolean; description?: string };\n\nexport type GenerationMetaTaskVariantSpec = {\n  description?: string;\n  required?: string[];\n  requiredContent?: Array<GenerationContentSpec[\"type\"]>;\n  sendTask?: boolean;\n};\n\nexport type GenerationMetaSpec = {\n  fields?: Record<string, GenerationMetaFieldSpec>;\n  taskField?: string;\n  taskVariants?: Record<string, GenerationMetaTaskVariantSpec>;\n};\n\nexport type GenerationModelDeclaration = {\n  schema: typeof MODEL_SCHEMA;\n  model: string;\n  title?: string;\n  description?: string;\n  allowUnknownParameters?: boolean;\n  adapter: {\n    type: string;\n  };\n  content: {\n    input: GenerationContentSpec[];\n  };\n  parameters?: Record<string, GenerationParameterSpec>;\n  meta?: GenerationMetaSpec;\n  examples?: Array<{\n    title?: string;\n    request: GenerateRequest;\n  }>;\n};\n\nexport type GenerateRequest = {\n  model: string;\n  content: GenerationContentBlock[];\n  parameters?: Record<string, unknown>;\n  meta?: Record<string, unknown>;\n  /** @deprecated Use meta. */\n  metadata?: Record<string, unknown>;\n  apiKey?: string;\n  baseUrl?: string;\n};\n\nexport type ResolvedGenerationRequest = {\n  declaration: GenerationModelDeclaration;\n  request: GenerateRequest;\n  parameters: Record<string, unknown>;\n  meta: Record<string, unknown>;\n};\n\nexport type GenerationSourceResolver = (source: GenerationSource) => Promise<string> | string;\n\nexport type GenerationDebugEvent =\n  | {\n      type: \"request\";\n      url: string;\n      method: string;\n      headers: Record<string, string>;\n      body?: unknown;\n    }\n  | {\n      type: \"response\";\n      url: string;\n      status: number;\n      statusText: string;\n      headers: Record<string, string>;\n      trace: Record<string, string>;\n      elapsedMs: number;\n      body?: unknown;\n    };\n\nexport type GenerationDebugLogger = (event: GenerationDebugEvent) => void;\n\nexport type GenerationDebugOptions = {\n  enabled?: boolean;\n  includeSensitive?: boolean;\n  includeResponseBody?: boolean;\n  logger?: GenerationDebugLogger;\n};\n\nexport type GenerationDebugConfig = GenerationDebugOptions & {\n  enabled: boolean;\n  includeSensitive: boolean;\n  includeResponseBody: boolean;\n  logger: GenerationDebugLogger;\n};\n\nexport type GenerationAdapterContext = {\n  apiKey: string;\n  baseUrl: string;\n  fetch: typeof fetch;\n  resolveSource: GenerationSourceResolver;\n};\n\nexport type GenerationAdapterInput = ResolvedGenerationRequest & {\n  context: GenerationAdapterContext;\n};\n\nexport type GenerationAdapter = (input: GenerationAdapterInput) => Promise<GenerationContentBlock[]>;\n\nexport type CreateGenerationClientOptions = {\n  apiKey?: string;\n  baseUrl?: string;\n  models?: GenerationModelDeclaration[];\n  includeBuiltinModels?: boolean;\n  fetch?: typeof fetch;\n  sourceResolver?: GenerationSourceResolver;\n  adapters?: Record<string, GenerationAdapter>;\n  debug?: boolean | GenerationDebugOptions;\n};\n\nexport type GenerationClient = {\n  generate(request: GenerateRequest): Promise<GenerationContentBlock[]>;\n  validate(request: GenerateRequest): ResolvedGenerationRequest;\n  listModels(): GenerationModelDeclaration[];\n  getModel(model: string): GenerationModelDeclaration | null;\n  stringifyModelConfig(model: string, options?: { format?: \"yaml\" | \"json\" }): string;\n  exportModelConfig(model: string, filePath: string): Promise<void>;\n  exportModelConfigs(directory: string): Promise<void>;\n};\n","import type { GenerationContentBlock } from \"./types.js\";\n\nexport function cloneJson<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nexport function slugifyFileName(value: string): string {\n  return (\n    value\n      .trim()\n      .toLowerCase()\n      .replace(/[^a-z0-9._-]+/g, \"-\")\n      .replace(/^-+|-+$/g, \"\") || \"model\"\n  );\n}\n\nexport function getBlockMeta(block: GenerationContentBlock): Record<string, unknown> | undefined {\n  return \"meta\" in block ? block.meta : undefined;\n}\n\nexport function compactArray<T>(values: T[]): T[] | undefined {\n  return values.length > 0 ? values : undefined;\n}\n\nexport function compactObject<T extends Record<string, unknown>>(value: T): T {\n  for (const key of Object.keys(value)) if (value[key] === undefined) delete value[key];\n  return value;\n}\n","import type { GenerationModelDeclaration } from \"./types.js\";\nimport { MODEL_SCHEMA } from \"./types.js\";\nimport { cloneJson } from \"./utils.js\";\n\nconst imageSizeParameters = {\n  size: {\n    type: \"string\",\n    optional: true,\n    default: \"1024x1024\",\n    description: \"Output image size.\",\n    examples: [\"auto\", \"1024x1024\", \"1536x1024\", \"1024x1536\", \"2048x2048\", \"2048x1152\", \"3840x2160\", \"2160x3840\"],\n  },\n  quality: {\n    type: \"string\",\n    optional: true,\n    default: \"auto\",\n    enum: [\"auto\", \"low\", \"medium\", \"high\"],\n    description: \"Image quality.\",\n  },\n} satisfies GenerationModelDeclaration[\"parameters\"];\n\nfunction videoParameters(defaults: { resolution: string; maxWait: number }) {\n  return {\n    duration: {\n      type: \"integer\",\n      optional: true,\n      default: 5,\n      min: 4,\n      max: 15,\n      description: \"Video duration in seconds.\",\n    },\n    resolution: {\n      type: \"string\",\n      optional: true,\n      default: defaults.resolution,\n      enum: [\"480p\", \"720p\", \"1080p\", \"2K\"],\n      description: \"Output video resolution.\",\n    },\n    aspect_ratio: {\n      type: \"string\",\n      optional: true,\n      default: \"16:9\",\n      enum: [\"16:9\", \"9:16\", \"1:1\", \"4:3\", \"3:2\", \"2:3\", \"3:4\", \"21:9\", \"adaptive\"],\n      description: \"Output aspect ratio. Use adaptive to let the model choose.\",\n    },\n    fps: { type: \"integer\", optional: true, default: 30, min: 1, max: 60, description: \"Frames per second.\" },\n    seed: { type: \"integer\", optional: true, description: \"Random seed for reproducibility.\" },\n    generate_audio: { type: \"boolean\", optional: true, default: true, description: \"Generate synchronized audio.\" },\n    return_last_frame: {\n      type: \"boolean\",\n      optional: true,\n      default: true,\n      description: \"Return the last frame as an image for chaining video segments.\",\n    },\n    camera_fixed: {\n      type: \"boolean\",\n      optional: true,\n      default: false,\n      description: \"Fix camera position when supported.\",\n    },\n    watermark: { type: \"boolean\", optional: true, default: false, description: \"Add AI Generated watermark.\" },\n    poll_interval: {\n      type: \"integer\",\n      optional: true,\n      default: 2,\n      min: 1,\n      max: 30,\n      description: \"Seconds between task status checks.\",\n    },\n    max_wait: {\n      type: \"integer\",\n      optional: true,\n      default: defaults.maxWait,\n      min: 30,\n      max: 1800,\n      description: \"Maximum seconds to wait for task completion.\",\n    },\n  } satisfies GenerationModelDeclaration[\"parameters\"];\n}\n\nconst sunoContinuationTaskVariant = {\n  required: [\"task_id\", \"clip_id\", \"continue_clip_id\"],\n};\n\nconst sunoMeta = {\n  taskField: \"task\",\n  fields: {\n    task: {\n      type: \"string\",\n      optional: true,\n      enum: [\n        \"extend\",\n        \"upload_extend\",\n        \"infill\",\n        \"fixed_infill\",\n        \"infill_intro\",\n        \"infill_outro\",\n        \"cover_infill\",\n        \"cover_extend\",\n        \"artist_infill\",\n        \"artist_consistency\",\n        \"cover\",\n        \"image_to_song\",\n        \"video_to_song\",\n        \"concat\",\n        \"sound\",\n        \"underpainting\",\n        \"remaster\",\n        \"vox\",\n        \"mashup_condition\",\n      ],\n      description: \"Integrated Suno music task for operation=music.\",\n    },\n    mv: { type: \"string\", optional: true, description: \"Suno music model version.\" },\n    task_id: {\n      type: \"string\",\n      optional: true,\n      description: \"Existing Suno task id used for continuation-style tasks.\",\n    },\n    clip_id: {\n      type: \"string\",\n      optional: true,\n      description: \"Existing Suno clip id used for continuation-style tasks.\",\n    },\n    continue_clip_id: { type: \"string\", optional: true, description: \"Clip id to continue from.\" },\n    continue_at: { type: \"number\", optional: true, description: \"Continue position in seconds.\" },\n    model_name: { type: \"string\", optional: true, description: \"Suno model name used by remaster.\" },\n    variation_category: { type: \"string\", optional: true, description: \"Remaster variation category.\" },\n    metadata_params: {\n      type: \"object\",\n      optional: true,\n      description: \"Yunwu/Suno task-specific metadata payload.\",\n    },\n  },\n  taskVariants: {\n    extend: sunoContinuationTaskVariant,\n    upload_extend: sunoContinuationTaskVariant,\n    infill: sunoContinuationTaskVariant,\n    fixed_infill: sunoContinuationTaskVariant,\n    infill_intro: sunoContinuationTaskVariant,\n    infill_outro: sunoContinuationTaskVariant,\n    cover_infill: sunoContinuationTaskVariant,\n    cover_extend: sunoContinuationTaskVariant,\n    artist_infill: sunoContinuationTaskVariant,\n    artist_consistency: sunoContinuationTaskVariant,\n    cover: sunoContinuationTaskVariant,\n    image_to_song: { requiredContent: [\"image\"], required: [\"metadata_params\"] },\n    video_to_song: { requiredContent: [\"video\"], required: [\"metadata_params\"] },\n    concat: sunoContinuationTaskVariant,\n    sound: { required: [\"metadata_params\"] },\n    underpainting: { required: [\"metadata_params\"] },\n    remaster: { sendTask: false, required: [\"clip_id\", \"model_name\", \"variation_category\"] },\n    vox: sunoContinuationTaskVariant,\n    mashup_condition: sunoContinuationTaskVariant,\n  },\n} satisfies GenerationModelDeclaration[\"meta\"];\n\nconst builtinModels = [\n  {\n    schema: MODEL_SCHEMA,\n    model: \"gpt-image-2\",\n    title: \"GPT Image 2\",\n    description:\n      \"Image generation model with optional reference images. Good for photorealistic scenes, detailed images, and image editing with references.\",\n    adapter: { type: \"openai.images\" },\n    content: {\n      input: [\n        { type: \"text\", required: true, min: 1, max: 16, merge: \"newline\", description: \"Prompt text.\" },\n        {\n          type: \"image\",\n          required: false,\n          max: 16,\n          sources: [\"url\", \"base64\"],\n          description: \"Optional reference images.\",\n        },\n      ],\n    },\n    parameters: imageSizeParameters,\n    examples: [\n      {\n        title: \"Basic image\",\n        request: {\n          model: \"gpt-image-2\",\n          content: [{ type: \"text\", text: \"a cyberpunk cat in neon rain\" }],\n          parameters: { size: \"1024x1024\", quality: \"auto\" },\n        },\n      },\n    ],\n  },\n  {\n    schema: MODEL_SCHEMA,\n    model: \"gemini-3.1-flash-image-preview\",\n    title: \"Gemini 3.1 Flash Image Preview\",\n    description:\n      \"Gemini image generation and editing model. Good for text rendering, infographics, style transfer, and iterative image editing with references.\",\n    adapter: { type: \"gemini.generateContent\" },\n    content: {\n      input: [\n        { type: \"text\", required: true, min: 1, max: 16, merge: \"newline\", description: \"Prompt text.\" },\n        {\n          type: \"image\",\n          required: false,\n          max: 14,\n          sources: [\"url\", \"base64\"],\n          description: \"Optional reference images.\",\n        },\n      ],\n    },\n    parameters: {\n      aspect_ratio: {\n        type: \"string\",\n        optional: true,\n        default: \"1:1\",\n        enum: [\"1:1\", \"16:9\", \"4:3\", \"3:2\", \"3:4\", \"2:3\", \"9:16\", \"5:4\", \"4:5\", \"21:9\", \"1:4\", \"4:1\", \"1:8\", \"8:1\"],\n        description: \"Output aspect ratio.\",\n      },\n      image_size: {\n        type: \"string\",\n        optional: true,\n        default: \"2K\",\n        enum: [\"512\", \"1K\", \"2K\", \"4K\"],\n        description: \"Output image resolution.\",\n      },\n    },\n    examples: [\n      {\n        title: \"Basic image\",\n        request: {\n          model: \"gemini-3.1-flash-image-preview\",\n          content: [\n            { type: \"text\", text: \"a vibrant infographic explaining photosynthesis with clear readable labels\" },\n          ],\n          parameters: { aspect_ratio: \"16:9\", image_size: \"1K\" },\n        },\n      },\n    ],\n  },\n  {\n    schema: MODEL_SCHEMA,\n    model: \"seedance-2-0\",\n    title: \"Seedance 2.0\",\n    description: \"Higher quality Ark video generation model for final production outputs.\",\n    adapter: { type: \"ark.videoGenerations\" },\n    content: {\n      input: [\n        { type: \"text\", required: true, min: 1, max: 16, merge: \"newline\", description: \"Video prompt.\" },\n        {\n          type: \"image\",\n          required: false,\n          max: 9,\n          sources: [\"url\", \"base64\"],\n          description: \"Optional image input. Use meta.role as first_frame, last_frame, or reference_image.\",\n        },\n      ],\n    },\n    parameters: videoParameters({ resolution: \"1080p\", maxWait: 900 }),\n  },\n  {\n    schema: MODEL_SCHEMA,\n    model: \"seedance-2-0-fast\",\n    title: \"Seedance 2.0 Fast\",\n    description:\n      \"Fast Ark video generation model for drafts, rapid iteration, text-to-video, image-to-video, and reference-guided video generation.\",\n    adapter: { type: \"ark.videoGenerations\" },\n    content: {\n      input: [\n        { type: \"text\", required: true, min: 1, max: 16, merge: \"newline\", description: \"Video prompt.\" },\n        {\n          type: \"image\",\n          required: false,\n          max: 9,\n          sources: [\"url\", \"base64\"],\n          description: \"Optional image input. Use meta.role as first_frame, last_frame, or reference_image.\",\n        },\n      ],\n    },\n    parameters: videoParameters({ resolution: \"720p\", maxWait: 600 }),\n  },\n  {\n    schema: MODEL_SCHEMA,\n    model: \"suno_music\",\n    title: \"Suno Music\",\n    description: \"Suno music model for songs, lyrics, sound effects, and integrated music tasks.\",\n    adapter: { type: \"suno.tasks\" },\n    content: {\n      input: [\n        {\n          type: \"text\",\n          required: false,\n          max: 16,\n          merge: \"newline\",\n          description:\n            \"Optional prompt text. The adapter maps merged text to the operation's text field when that field is not provided.\",\n        },\n        {\n          type: \"audio\",\n          required: false,\n          max: 1,\n          sources: [\"url\", \"base64\"],\n          description: \"Optional reference audio. The adapter maps it to url when url is not provided.\",\n        },\n        {\n          type: \"image\",\n          required: false,\n          max: 1,\n          sources: [\"url\", \"base64\"],\n          description: \"Optional image source. The adapter maps it to image_url when image_url is not provided.\",\n        },\n        {\n          type: \"video\",\n          required: false,\n          max: 1,\n          sources: [\"url\", \"base64\"],\n          description: \"Optional video source. The adapter maps it to video_url when video_url is not provided.\",\n        },\n      ],\n    },\n    parameters: {\n      operation: {\n        type: \"string\",\n        optional: true,\n        default: \"music\",\n        enum: [\"music\", \"lyrics\"],\n        description:\n          \"Stable Suno endpoint operation. Provider-specific fields such as task, mv, title, tags, metadataParams, and clip_id belong in request meta.\",\n      },\n      poll_interval: {\n        type: \"integer\",\n        optional: true,\n        default: 5,\n        min: 1,\n        max: 60,\n        description: \"Seconds between task status checks.\",\n      },\n      max_wait: {\n        type: \"integer\",\n        optional: true,\n        default: 600,\n        min: 30,\n        max: 3600,\n        description: \"Maximum seconds to wait for task completion.\",\n      },\n    },\n    meta: sunoMeta,\n    examples: [\n      {\n        title: \"Music generation\",\n        request: {\n          model: \"suno_music\",\n          content: [{ type: \"text\", text: \"uplifting cinematic pop with warm piano and clear chorus\" }],\n          parameters: { operation: \"music\" },\n          meta: {\n            mv: \"chirp-v5-5\",\n            title: \"Warm Horizon\",\n            tags: \"cinematic pop, warm piano\",\n            make_instrumental: false,\n          },\n        },\n      },\n      {\n        title: \"Lyrics\",\n        request: {\n          model: \"suno_music\",\n          content: [{ type: \"text\", text: \"write a hopeful chorus about sunrise after a storm\" }],\n          parameters: { operation: \"lyrics\" },\n        },\n      },\n      {\n        title: \"Sound effect\",\n        request: {\n          model: \"suno_music\",\n          content: [{ type: \"text\", text: \"ambient music with gentle rain and distant thunder\" }],\n          parameters: { operation: \"music\" },\n          meta: {\n            task: \"sound\",\n            mv: \"chirp-v5-5\",\n            metadata_params: { sound: \"gentle rain ambience with distant thunder\" },\n            title: \"Gentle Rain\",\n            tags: \"ambient, rain, cinematic\",\n            make_instrumental: true,\n          },\n        },\n      },\n      {\n        title: \"Image to song\",\n        request: {\n          model: \"suno_music\",\n          content: [\n            { type: \"text\", text: \"turn this image into a short hopeful pop song\" },\n            { type: \"image\", source: { type: \"url\", url: \"https://picsum.photos/512/512\" } },\n          ],\n          parameters: { operation: \"music\" },\n          meta: {\n            task: \"image_to_song\",\n            mv: \"chirp-v5-5\",\n            metadata_params: {\n              image_url: \"https://picsum.photos/512/512\",\n              prompt: \"turn this image into a short hopeful pop song\",\n            },\n          },\n        },\n      },\n    ],\n  },\n] satisfies GenerationModelDeclaration[];\n\nexport const builtinGenerationModels: GenerationModelDeclaration[] = cloneJson(builtinModels);\n\nexport function getBuiltinGenerationModel(model: string): GenerationModelDeclaration | null {\n  return cloneJson(builtinModels.find((declaration) => declaration.model === model) ?? null);\n}\n\nexport function listBuiltinGenerationModels(): GenerationModelDeclaration[] {\n  return cloneJson(builtinModels);\n}\n"],"mappings":"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"}

package/dist/builtins.d.ts

@@ -1,2 +1,2 @@
-import { n as getBuiltinGenerationModel, r as listBuiltinGenerationModels, t as builtinGenerationModels } from "./builtins-BuI-rf8X.js";
+import { n as getBuiltinGenerationModel, r as listBuiltinGenerationModels, t as builtinGenerationModels } from "./builtins-BJ2_TVlr.js";
 export { builtinGenerationModels, getBuiltinGenerationModel, listBuiltinGenerationModels };

package/dist/builtins.js

@@ -1,3 +1,3 @@
-import { n as getBuiltinGenerationModel, r as listBuiltinGenerationModels, t as builtinGenerationModels } from "./builtins-B1AheaEa.js";
+import { n as getBuiltinGenerationModel, r as listBuiltinGenerationModels, t as builtinGenerationModels } from "./builtins-FumzmWvj.js";
 
 export { builtinGenerationModels, getBuiltinGenerationModel, listBuiltinGenerationModels };

package/dist/cli/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { r as listBuiltinGenerationModels } from "../builtins-B1AheaEa.js";
-import { n as exportBuiltinModelConfigs, t as exportBuiltinModelConfig, u as stringifyGenerationModelDeclaration } from "../export-config-Bwqnn7Vs.js";
+import { r as listBuiltinGenerationModels } from "../builtins-FumzmWvj.js";
+import { h as stringifyGenerationModelDeclaration, i as createGenerationClient, n as exportBuiltinModelConfigs, t as exportBuiltinModelConfig } from "../export-config-D8By2_r7.js";
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 
@@ -9,9 +9,13 @@ function usage() {
 	console.log(`neta-generation
 
 Usage:
+  neta-generation generate <model> --prompt <text> [--param key=value] [--image-url <url>] [--out <directory>] [--debug] [--debug-sensitive] [--no-debug-response-body]
   neta-generation models list
   neta-generation models export <model> --out <file>
   neta-generation models export-all --out <directory>
+
+Environment:
+  NETA_ROUTER_API_KEY  API key used by generate
 `);
 	process.exit(1);
 }
@@ -20,8 +24,86 @@ function readOption(args, name) {
 	if (index < 0) return null;
 	return args[index + 1] ?? null;
 }
+function readOptions(args, name) {
+	const values = [];
+	for (let index = 0; index < args.length; index += 1) {
+		const value = args[index + 1];
+		if (args[index] === name && value) values.push(value);
+	}
+	return values;
+}
+function hasFlag(args, name) {
+	return args.includes(name);
+}
+function parseParameterValue(raw) {
+	if (raw.startsWith("json:")) return JSON.parse(raw.slice(5));
+	if (raw === "true") return true;
+	if (raw === "false") return false;
+	return raw;
+}
+function parseParameter(value) {
+	const separator = value.indexOf("=");
+	if (separator <= 0) throw new Error(`Invalid --param value: ${value}`);
+	return [value.slice(0, separator), parseParameterValue(value.slice(separator + 1))];
+}
+function outputSummary(block) {
+	if (block.type === "text") return block;
+	return {
+		type: block.type,
+		source: block.source.type === "url" ? block.source : {
+			type: "base64",
+			mediaType: block.source.mediaType,
+			bytes: Buffer.byteLength(block.source.data, "base64")
+		},
+		meta: block.meta
+	};
+}
+async function writeOutputFiles(directory, output) {
+	await mkdir(directory, { recursive: true });
+	await Promise.all(output.map(async (block, index) => {
+		if (block.type !== "image" && block.type !== "video" && block.type !== "audio" || block.source.type !== "base64") return;
+		const extension = block.source.mediaType.split("/")[1]?.split("+")[0] || block.type;
+		await writeFile(join(directory, `${String(index + 1).padStart(2, "0")}.${extension}`), Buffer.from(block.source.data, "base64"));
+	}));
+}
 async function main() {
 	const args = process.argv.slice(2);
+	if (args[0] === "generate") {
+		const model = args[1];
+		const prompt = readOption(args, "--prompt");
+		const apiKey = process.env.NETA_ROUTER_API_KEY;
+		if (!model || !prompt || !apiKey) usage();
+		const outputDirectory = readOption(args, "--out");
+		const content = [{
+			type: "text",
+			text: prompt
+		}, ...readOptions(args, "--image-url").map((url) => ({
+			type: "image",
+			source: {
+				type: "url",
+				url
+			}
+		}))];
+		const parameters = Object.fromEntries(readOptions(args, "--param").map(parseParameter));
+		const baseUrl = readOption(args, "--base-url");
+		const debug = hasFlag(args, "--debug") ? {
+			enabled: true,
+			includeSensitive: hasFlag(args, "--debug-sensitive"),
+			includeResponseBody: !hasFlag(args, "--no-debug-response-body")
+		} : void 0;
+		const output = await createGenerationClient({
+			apiKey,
+			...baseUrl ? { baseUrl } : {},
+			...debug ? { debug } : {}
+		}).generate({
+			model,
+			content,
+			parameters
+		});
+		if (outputDirectory) await writeOutputFiles(outputDirectory, output);
+		console.log(JSON.stringify(output.map(outputSummary), null, 2));
+		return;
+	}
 	if (args[0] !== "models") usage();
 	switch (args[1]) {
 		case "list":