@neta-art/generation 0.1.4 → 0.1.6

package/README.md

@@ -60,6 +60,13 @@ pnpm example:image-editing
 pnpm example:text-to-video
 ```
 
+Live provider tests are separate from `pnpm test` because they use the real SDK client and submit real provider requests. Set
+`NETA_ROUTER_API_KEY` or `NETA_API_KEY`, then run:
+
+```bash
+pnpm test:live:suno
+```
+
 You can also call providers through the CLI:
 
 ```bash
@@ -83,7 +90,7 @@ const client = createGenerationClient({
 });
 ```
 
-For a custom logger or full unredacted payloads:
+For a custom logger or unredacted secret headers. Base64 media payloads are always redacted from debug events:
 
 ```ts
 const client = createGenerationClient({
@@ -99,10 +106,27 @@ const client = createGenerationClient({
 ## Built-in models
 
 - `gpt-image-2`
+- `z-image-turbo`
+- `qwen-image-edit`
 - `gemini-3.1-flash-image-preview`
+- `kling-text-to-video`
+- `kling-image-to-video`
+- `kling-omni-video`
+- `kling-multi-image-to-video`
 - `seedance-2-0`
 - `seedance-2-0-fast`
-- `suno_music`
+- `suno_music_chirp_fenix`
+- `noobxl-t2i-onediff`
+- `noobxl-i2i-ipa-onediff`
+- `birefnet-general`
+- `suno_style_tags`
+- `suno_upload_audio`
+- `suno_cover_chirp_v5`
+- `suno_infill_chirp_v5`
+- `suno_sound_chirp_v5`
+- `suno_image_to_song_chirp_v5`
+- `suno_video_to_song_chirp_v5`
+- `suno_vox_chirp_v5`
 
 Built-in model declarations share the same client-level `apiKey` and `baseUrl`.
 
@@ -122,6 +146,53 @@ const output = await client.generate({
 });
 ```
 
+## Image models
+
+These image models use the same client API as the other built-in models:
+
+- `z-image-turbo`
+- `qwen-image-edit`
+- `noobxl-t2i-onediff`
+- `noobxl-i2i-ipa-onediff`
+- `birefnet-general`
+
+```ts
+await client.generate({
+  model: "z-image-turbo",
+  content: [{ type: "text", text: "a clean product-style image of a small red toy robot" }],
+  parameters: {
+    size: "1024*1024",
+  },
+});
+
+await client.generate({
+  model: "qwen-image-edit",
+  content: [
+    { type: "text", text: "change the background to a clean white studio backdrop" },
+    { type: "image", source: { type: "url", url: "https://example.com/input.png" } },
+  ],
+  parameters: {
+    size: "1024x1024",
+  },
+});
+
+await client.generate({
+  model: "noobxl-t2i-onediff",
+  content: [{ type: "text", text: "anime key visual, luminous city at night" }],
+  parameters: {
+    size: "1024x1024",
+    negative_prompt: "low quality, blurry",
+  },
+});
+
+await client.generate({
+  model: "birefnet-general",
+  content: [
+    { type: "image", source: { type: "url", url: "https://example.com/portrait.png" } },
+  ],
+});
+```
+
 ## Video generation
 
 ```ts
@@ -151,19 +222,31 @@ await client.generate({
 });
 ```
 
+Kling exposes stable capability model ids while the adapter sends the latest upstream `model_name` for each capability:
+
+```ts
+await client.generate({
+  model: "kling-image-to-video",
+  content: [
+    { type: "text", text: "gently turn toward the camera with soft natural motion" },
+    { type: "image", source: { type: "url", url: "https://example.com/input.png" } },
+  ],
+  parameters: {
+    duration: 5,
+    aspect_ratio: "16:9",
+  },
+});
+```
+
 ## Music generation
 
 ```ts
 const output = await client.generate({
-  model: "suno_music",
+  model: "suno_music_chirp_fenix",
   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,
@@ -173,14 +256,12 @@ const output = await client.generate({
 console.log(output);
 ```
 
-Suno uses one public model, `suno_music`. SDK-level parameters control execution:
-
-- `music`
-- `lyrics`
+Suno uses one shared adapter with a small public model set: `suno_music_chirp_fenix`, `suno_style_tags`,
+`suno_upload_audio`, `suno_cover_chirp_v5`, `suno_infill_chirp_v5`, `suno_sound_chirp_v5`,
+`suno_image_to_song_chirp_v5`, `suno_video_to_song_chirp_v5`, and `suno_vox_chirp_v5`. Provider-specific fields such as
+`title`, `tags`, `make_instrumental`, and `metadata_params` belong in `meta`.
 
-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`.
+`suno_music` is removed in this release. Migrate to a concrete model name and stop sending `parameters.operation` or `meta.task`.
 
 ## Load model declarations from files
 
@@ -259,8 +340,10 @@ type GenerationSource =
 Built-in adapters:
 
 - `openai.images`
+- `openai.imageEdits`
 - `gemini.generateContent`
 - `ark.videoGenerations`
+- `kling.videoGenerations`
 - `suno.tasks`
 
 You can register custom adapters:

package/dist/{builtins-BJ2_TVlr.d.ts → builtins-C-_aGhT8.d.ts}

@@ -90,7 +90,7 @@ type GenerationModelDeclaration = {
   allowUnknownParameters?: boolean;
   adapter: {
     type: string;
-  };
+  } & Record<string, unknown>;
   content: {
     input: GenerationContentSpec[];
   };
@@ -185,4 +185,4 @@ declare function getBuiltinGenerationModel(model: string): GenerationModelDeclar
 declare function listBuiltinGenerationModels(): GenerationModelDeclaration[];
 //#endregion
 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
+//# sourceMappingURL=builtins-C-_aGhT8.d.ts.map

package/dist/builtins-C-_aGhT8.d.ts.map

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