@tokenlabai/mcp-server 0.6.17 → 0.6.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +3 -2
  2. package/contract/openapi.json +935 -309
  3. package/generated/public-contract.json +6 -6
  4. package/generated/tools.json +547 -288
  5. package/package.json +1 -1
  6. package/src/index.js +67 -6
  7. package/src/tool-schema.js +19 -6
package/generated/tools.json CHANGED
@@ -3,10 +3,10 @@
3
3
  "generated_at": null,
4
4
  "source": {
5
5
  "url": "https://docs.tokenlab.sh/openapi.json",
6
- "openapi": "3.0.3",
6
+ "openapi": "3.1.0",
7
7
  "title": "TokenLab AI Gateway",
8
8
  "version": "1.0.0",
9
- "sha256": "85963db54cafb169aaf6e9c28bf200cc217f59a9d457ed61fe80ba7047d1d511"
9
+ "sha256": "d45184d659f5f4c7d9b451e961e692e4e29faf451c0c8dc2e77f62df2821f35f"
10
10
  },
11
11
  "default_profile": "core",
12
12
  "profiles": [
@@ -51,12 +51,12 @@
51
51
  },
52
52
  "core": {
53
53
  "endpoint_tools": 29,
54
- "input_schema_bytes": 44738,
54
+ "input_schema_bytes": 43184,
55
55
  "max_input_schema_depth": 8
56
56
  },
57
57
  "full": {
58
58
  "endpoint_tools": 78,
59
- "input_schema_bytes": 69847,
59
+ "input_schema_bytes": 69395,
60
60
  "max_input_schema_depth": 8
61
61
  }
62
62
  },
@@ -233,6 +233,15 @@
233
233
  "$schema": "http://json-schema.org/draft-07/schema#",
234
234
  "type": "object",
235
235
  "properties": {
236
+ "X-TokenLab-Delivery-Policy": {
237
+ "type": "string",
238
+ "enum": [
239
+ "auto",
240
+ "verified",
241
+ "official"
242
+ ],
243
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
244
+ },
236
245
  "model": {
237
246
  "type": "string",
238
247
  "description": "Model to use for compaction. Codex CLI sends the current session model."
@@ -268,7 +277,9 @@
268
277
  "bindings": {
269
278
  "path": [],
270
279
  "query": [],
271
- "header": [],
280
+ "header": [
281
+ "X-TokenLab-Delivery-Policy"
282
+ ],
272
283
  "body": [
273
284
  "model",
274
285
  "input",
@@ -478,6 +489,15 @@
478
489
  "$schema": "http://json-schema.org/draft-07/schema#",
479
490
  "type": "object",
480
491
  "properties": {
492
+ "X-TokenLab-Delivery-Policy": {
493
+ "type": "string",
494
+ "enum": [
495
+ "auto",
496
+ "verified",
497
+ "official"
498
+ ],
499
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
500
+ },
481
501
  "model": {
482
502
  "type": "string",
483
503
  "default": "tripo-h3.1"
@@ -531,7 +551,9 @@
531
551
  "bindings": {
532
552
  "path": [],
533
553
  "query": [],
534
- "header": [],
554
+ "header": [
555
+ "X-TokenLab-Delivery-Policy"
556
+ ],
535
557
  "body": [
536
558
  "model",
537
559
  "prompt",
@@ -589,6 +611,15 @@
589
611
  "$schema": "http://json-schema.org/draft-07/schema#",
590
612
  "type": "object",
591
613
  "properties": {
614
+ "X-TokenLab-Delivery-Policy": {
615
+ "type": "string",
616
+ "enum": [
617
+ "auto",
618
+ "verified",
619
+ "official"
620
+ ],
621
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
622
+ },
592
623
  "model": {
593
624
  "type": "string",
594
625
  "description": "Model to use (e.g., claude-sonnet-4-6)"
@@ -738,7 +769,9 @@
738
769
  "bindings": {
739
770
  "path": [],
740
771
  "query": [],
741
- "header": [],
772
+ "header": [
773
+ "X-TokenLab-Delivery-Policy"
774
+ ],
742
775
  "body": [
743
776
  "model",
744
777
  "max_tokens",
@@ -787,6 +820,15 @@
787
820
  "$schema": "http://json-schema.org/draft-07/schema#",
788
821
  "type": "object",
789
822
  "properties": {
823
+ "X-TokenLab-Delivery-Policy": {
824
+ "type": "string",
825
+ "enum": [
826
+ "auto",
827
+ "verified",
828
+ "official"
829
+ ],
830
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
831
+ },
790
832
  "requests": {
791
833
  "type": "array",
792
834
  "minItems": 1,
@@ -967,7 +1009,9 @@
967
1009
  "bindings": {
968
1010
  "path": [],
969
1011
  "query": [],
970
- "header": [],
1012
+ "header": [
1013
+ "X-TokenLab-Delivery-Policy"
1014
+ ],
971
1015
  "body": [
972
1016
  "requests"
973
1017
  ],
@@ -999,6 +1043,15 @@
999
1043
  "$schema": "http://json-schema.org/draft-07/schema#",
1000
1044
  "type": "object",
1001
1045
  "properties": {
1046
+ "X-TokenLab-Delivery-Policy": {
1047
+ "type": "string",
1048
+ "enum": [
1049
+ "auto",
1050
+ "verified",
1051
+ "official"
1052
+ ],
1053
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
1054
+ },
1002
1055
  "input_file_id": {
1003
1056
  "type": "string"
1004
1057
  },
@@ -1050,7 +1103,9 @@
1050
1103
  "bindings": {
1051
1104
  "path": [],
1052
1105
  "query": [],
1053
- "header": [],
1106
+ "header": [
1107
+ "X-TokenLab-Delivery-Policy"
1108
+ ],
1054
1109
  "body": [
1055
1110
  "input_file_id",
1056
1111
  "endpoint",
@@ -1087,6 +1142,15 @@
1087
1142
  "$schema": "http://json-schema.org/draft-07/schema#",
1088
1143
  "type": "object",
1089
1144
  "properties": {
1145
+ "X-TokenLab-Delivery-Policy": {
1146
+ "type": "string",
1147
+ "enum": [
1148
+ "auto",
1149
+ "verified",
1150
+ "official"
1151
+ ],
1152
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
1153
+ },
1090
1154
  "model": {
1091
1155
  "type": "string",
1092
1156
  "description": "ID of the model to use (e.g., gpt-5.4, claude-sonnet-4-6)"
@@ -1551,7 +1615,9 @@
1551
1615
  "bindings": {
1552
1616
  "path": [],
1553
1617
  "query": [],
1554
- "header": [],
1618
+ "header": [
1619
+ "X-TokenLab-Delivery-Policy"
1620
+ ],
1555
1621
  "body": [
1556
1622
  "model",
1557
1623
  "messages",
@@ -1615,6 +1681,15 @@
1615
1681
  "$schema": "http://json-schema.org/draft-07/schema#",
1616
1682
  "type": "object",
1617
1683
  "properties": {
1684
+ "X-TokenLab-Delivery-Policy": {
1685
+ "type": "string",
1686
+ "enum": [
1687
+ "auto",
1688
+ "verified",
1689
+ "official"
1690
+ ],
1691
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
1692
+ },
1618
1693
  "model": {
1619
1694
  "type": "string",
1620
1695
  "description": "ID of the model to use"
@@ -1676,7 +1751,9 @@
1676
1751
  "bindings": {
1677
1752
  "path": [],
1678
1753
  "query": [],
1679
- "header": [],
1754
+ "header": [
1755
+ "X-TokenLab-Delivery-Policy"
1756
+ ],
1680
1757
  "body": [
1681
1758
  "model",
1682
1759
  "input",
@@ -1713,6 +1790,15 @@
1713
1790
  "$schema": "http://json-schema.org/draft-07/schema#",
1714
1791
  "type": "object",
1715
1792
  "properties": {
1793
+ "X-TokenLab-Delivery-Policy": {
1794
+ "type": "string",
1795
+ "enum": [
1796
+ "auto",
1797
+ "verified",
1798
+ "official"
1799
+ ],
1800
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
1801
+ },
1716
1802
  "model": {
1717
1803
  "type": "string",
1718
1804
  "description": "Model name (e.g., gemini-2.5-pro)"
@@ -2159,7 +2245,9 @@
2159
2245
  "model"
2160
2246
  ],
2161
2247
  "query": [],
2162
- "header": [],
2248
+ "header": [
2249
+ "X-TokenLab-Delivery-Policy"
2250
+ ],
2163
2251
  "body": [
2164
2252
  "contents",
2165
2253
  "systemInstruction",
@@ -2203,6 +2291,15 @@
2203
2291
  "$schema": "http://json-schema.org/draft-07/schema#",
2204
2292
  "type": "object",
2205
2293
  "properties": {
2294
+ "X-TokenLab-Delivery-Policy": {
2295
+ "type": "string",
2296
+ "enum": [
2297
+ "auto",
2298
+ "verified",
2299
+ "official"
2300
+ ],
2301
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
2302
+ },
2206
2303
  "prompt": {
2207
2304
  "type": "string",
2208
2305
  "maxLength": 4000,
@@ -2359,7 +2456,9 @@
2359
2456
  "bindings": {
2360
2457
  "path": [],
2361
2458
  "query": [],
2362
- "header": [],
2459
+ "header": [
2460
+ "X-TokenLab-Delivery-Policy"
2461
+ ],
2363
2462
  "body": [
2364
2463
  "prompt",
2365
2464
  "model",
@@ -2436,6 +2535,15 @@
2436
2535
  "$schema": "http://json-schema.org/draft-07/schema#",
2437
2536
  "type": "object",
2438
2537
  "properties": {
2538
+ "X-TokenLab-Delivery-Policy": {
2539
+ "type": "string",
2540
+ "enum": [
2541
+ "auto",
2542
+ "verified",
2543
+ "official"
2544
+ ],
2545
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
2546
+ },
2439
2547
  "model": {
2440
2548
  "type": "string",
2441
2549
  "description": "Model to use. Send this explicitly."
@@ -2555,7 +2663,9 @@
2555
2663
  "bindings": {
2556
2664
  "path": [],
2557
2665
  "query": [],
2558
- "header": [],
2666
+ "header": [
2667
+ "X-TokenLab-Delivery-Policy"
2668
+ ],
2559
2669
  "body": [
2560
2670
  "model",
2561
2671
  "prompt",
@@ -2633,6 +2743,15 @@
2633
2743
  "$schema": "http://json-schema.org/draft-07/schema#",
2634
2744
  "type": "object",
2635
2745
  "properties": {
2746
+ "X-TokenLab-Delivery-Policy": {
2747
+ "type": "string",
2748
+ "enum": [
2749
+ "auto",
2750
+ "verified",
2751
+ "official"
2752
+ ],
2753
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
2754
+ },
2636
2755
  "image": {
2637
2756
  "type": "string",
2638
2757
  "description": "Pass local file path."
@@ -2664,7 +2783,9 @@
2664
2783
  "bindings": {
2665
2784
  "path": [],
2666
2785
  "query": [],
2667
- "header": [],
2786
+ "header": [
2787
+ "X-TokenLab-Delivery-Policy"
2788
+ ],
2668
2789
  "body": [
2669
2790
  "image",
2670
2791
  "model",
@@ -2704,6 +2825,15 @@
2704
2825
  "$schema": "http://json-schema.org/draft-07/schema#",
2705
2826
  "type": "object",
2706
2827
  "properties": {
2828
+ "X-TokenLab-Delivery-Policy": {
2829
+ "type": "string",
2830
+ "enum": [
2831
+ "auto",
2832
+ "verified",
2833
+ "official"
2834
+ ],
2835
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
2836
+ },
2707
2837
  "model": {
2708
2838
  "type": "string",
2709
2839
  "description": "Model to use for multimodal embeddings"
@@ -2777,7 +2907,9 @@
2777
2907
  "bindings": {
2778
2908
  "path": [],
2779
2909
  "query": [],
2780
- "header": [],
2910
+ "header": [
2911
+ "X-TokenLab-Delivery-Policy"
2912
+ ],
2781
2913
  "body": [
2782
2914
  "model",
2783
2915
  "input",
@@ -2812,6 +2944,15 @@
2812
2944
  "$schema": "http://json-schema.org/draft-07/schema#",
2813
2945
  "type": "object",
2814
2946
  "properties": {
2947
+ "X-TokenLab-Delivery-Policy": {
2948
+ "type": "string",
2949
+ "enum": [
2950
+ "auto",
2951
+ "verified",
2952
+ "official"
2953
+ ],
2954
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
2955
+ },
2815
2956
  "model": {
2816
2957
  "type": "string",
2817
2958
  "default": "suno_music"
@@ -2886,7 +3027,9 @@
2886
3027
  "bindings": {
2887
3028
  "path": [],
2888
3029
  "query": [],
2889
- "header": [],
3030
+ "header": [
3031
+ "X-TokenLab-Delivery-Policy"
3032
+ ],
2890
3033
  "body": [
2891
3034
  "model",
2892
3035
  "prompt",
@@ -2947,6 +3090,15 @@
2947
3090
  "$schema": "http://json-schema.org/draft-07/schema#",
2948
3091
  "type": "object",
2949
3092
  "properties": {
3093
+ "X-TokenLab-Delivery-Policy": {
3094
+ "type": "string",
3095
+ "enum": [
3096
+ "auto",
3097
+ "verified",
3098
+ "official"
3099
+ ],
3100
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
3101
+ },
2950
3102
  "model": {
2951
3103
  "type": "string",
2952
3104
  "description": "Model to use"
@@ -3073,7 +3225,9 @@
3073
3225
  "bindings": {
3074
3226
  "path": [],
3075
3227
  "query": [],
3076
- "header": [],
3228
+ "header": [
3229
+ "X-TokenLab-Delivery-Policy"
3230
+ ],
3077
3231
  "body": [
3078
3232
  "model",
3079
3233
  "input",
@@ -3169,16 +3323,12 @@
3169
3323
  "description": "Project scope for the material asset. Assets and groups are isolated by project inside the authenticated organization."
3170
3324
  },
3171
3325
  "metadata": {
3172
- "anyOf": [
3173
- {
3174
- "type": "object",
3175
- "additionalProperties": true,
3176
- "description": "Optional client metadata stored with the material asset."
3177
- },
3178
- {
3179
- "type": "null"
3180
- }
3181
- ]
3326
+ "type": [
3327
+ "object",
3328
+ "null"
3329
+ ],
3330
+ "additionalProperties": true,
3331
+ "description": "Optional client metadata stored with the material asset."
3182
3332
  }
3183
3333
  },
3184
3334
  "required": [
@@ -3234,15 +3384,11 @@
3234
3384
  "description": "Optional display name for the material group."
3235
3385
  },
3236
3386
  "description": {
3237
- "anyOf": [
3238
- {
3239
- "type": "string",
3240
- "maxLength": 500
3241
- },
3242
- {
3243
- "type": "null"
3244
- }
3245
- ]
3387
+ "type": [
3388
+ "string",
3389
+ "null"
3390
+ ],
3391
+ "maxLength": 500
3246
3392
  },
3247
3393
  "library_type": {
3248
3394
  "type": "string",
@@ -3261,15 +3407,11 @@
3261
3407
  "description": "Project scope for the material group."
3262
3408
  },
3263
3409
  "metadata": {
3264
- "anyOf": [
3265
- {
3266
- "type": "object",
3267
- "additionalProperties": true
3268
- },
3269
- {
3270
- "type": "null"
3271
- }
3272
- ]
3410
+ "type": [
3411
+ "object",
3412
+ "null"
3413
+ ],
3414
+ "additionalProperties": true
3273
3415
  }
3274
3416
  },
3275
3417
  "additionalProperties": false
@@ -3314,6 +3456,15 @@
3314
3456
  "$schema": "http://json-schema.org/draft-07/schema#",
3315
3457
  "type": "object",
3316
3458
  "properties": {
3459
+ "X-TokenLab-Delivery-Policy": {
3460
+ "type": "string",
3461
+ "enum": [
3462
+ "auto",
3463
+ "verified",
3464
+ "official"
3465
+ ],
3466
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
3467
+ },
3317
3468
  "model": {
3318
3469
  "type": "string",
3319
3470
  "default": "tts-1",
@@ -3396,7 +3547,9 @@
3396
3547
  "bindings": {
3397
3548
  "path": [],
3398
3549
  "query": [],
3399
- "header": [],
3550
+ "header": [
3551
+ "X-TokenLab-Delivery-Policy"
3552
+ ],
3400
3553
  "body": [
3401
3554
  "model",
3402
3555
  "input",
@@ -3439,6 +3592,15 @@
3439
3592
  "$schema": "http://json-schema.org/draft-07/schema#",
3440
3593
  "type": "object",
3441
3594
  "properties": {
3595
+ "X-TokenLab-Delivery-Policy": {
3596
+ "type": "string",
3597
+ "enum": [
3598
+ "auto",
3599
+ "verified",
3600
+ "official"
3601
+ ],
3602
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
3603
+ },
3442
3604
  "prompt": {
3443
3605
  "type": "string",
3444
3606
  "description": "Video description"
@@ -3504,6 +3666,14 @@
3504
3666
  ],
3505
3667
  "description": "Video resolution. Seedance defaults to 720p when omitted; available values are model-dependent."
3506
3668
  },
3669
+ "output_format": {
3670
+ "type": "string",
3671
+ "enum": [
3672
+ "mp4",
3673
+ "mov"
3674
+ ],
3675
+ "description": "Video container format for compatible models. Seedance 2.5 supports mp4 and mov; omit this field for Seedance 2.0 and other models that do not publish an output-format selector."
3676
+ },
3507
3677
  "output_audio": {
3508
3678
  "type": "boolean",
3509
3679
  "description": "Canonical model-dependent audio output toggle. Veo 3 and Seedance requests default to true when omitted. Kling 3.0 Video accepts this selector for non-element-reference requests and maps it to the compatible sound control; omitted Kling requests default to silent output. Do not combine output_audio=true with kling_elements. The aliases outputAudio and generate_audio are accepted for compatibility and must match when provided together."
@@ -3522,7 +3692,7 @@
3522
3692
  "type": "integer",
3523
3693
  "minimum": -1,
3524
3694
  "maximum": 4294967295,
3525
- "description": "Seed for reproducibility. Seedance uses -1 for random seed when omitted."
3695
+ "description": "Seed for reproducibility on compatible models. Compatible Seedance models use -1 for a random seed when omitted; Seedance 2.5 does not support this field."
3526
3696
  },
3527
3697
  "cfg_scale": {
3528
3698
  "type": "number",
@@ -3550,9 +3720,9 @@
3550
3720
  },
3551
3721
  "image_urls": {
3552
3722
  "type": "array",
3553
- "description": "Image URL array for compatible image-conditioned video flows. This endpoint currently allows up to 9 entries. When the selected Seedance model can use the TokenLab material library, TokenLab prepares this image input as reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path.",
3723
+ "description": "Image URL array for compatible image-conditioned video flows. Seedance 2.5 accepts up to 30 aggregate image inputs; other video models retain the shared limit of 9 entries unless the model details specify a lower limit. When the selected Seedance model can use the TokenLab material library, TokenLab prepares this image input as reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path.",
3554
3724
  "minItems": 1,
3555
- "maxItems": 9,
3725
+ "maxItems": 30,
3556
3726
  "items": {
3557
3727
  "type": "string",
3558
3728
  "format": "uri"
@@ -3598,9 +3768,9 @@
3598
3768
  },
3599
3769
  "reference_images": {
3600
3770
  "type": "array",
3601
- "description": "Canonical public reference-image field for reference-to-video conditioning. This endpoint currently allows up to 9 URLs, compatible data URLs, or for Seedance, asset://asset-YYYYMMDDHHMMSS-xxxxx URIs for ACTIVE TokenLab materials owned by the requesting organization; model-specific limits can be lower. xAI grok-imagine-video accepts up to 7 image references with duration capped at 10 seconds; grok-imagine-video-1.5 and grok-imagine-video-1.5-preview are image-to-video only and do not accept reference images. When the selected Seedance model can use the TokenLab material library, TokenLab prepares ordinary image input as reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path.",
3771
+ "description": "Canonical public reference-image field for reference-to-video conditioning. Seedance 2.5 accepts up to 30 aggregate image inputs; other video models retain the shared limit of 9 URLs or compatible data URLs unless the model details specify a lower limit. xAI grok-imagine-video accepts up to 7 image references with duration capped at 10 seconds; grok-imagine-video-1.5 and grok-imagine-video-1.5-preview are image-to-video only and do not accept reference images. When the selected Seedance model can use the TokenLab material library, TokenLab prepares ordinary image input as reusable material before generation; if it is not ACTIVE within 60 seconds, the API returns 409 seedance_material_preparing with auto_material_asset_ids. If the selected model cannot use the material library, ordinary image inputs continue on the regular image path.",
3602
3772
  "minItems": 1,
3603
- "maxItems": 9,
3773
+ "maxItems": 30,
3604
3774
  "items": {
3605
3775
  "type": "string"
3606
3776
  }
@@ -3664,9 +3834,9 @@
3664
3834
  },
3665
3835
  "video_urls": {
3666
3836
  "type": "array",
3667
- "description": "Compatibility array for video-conditioned flows when multiple input videos are supported by the routed model family. TokenLab currently accepts up to 3 reference videos.",
3837
+ "description": "Compatibility array for video-conditioned flows when multiple input videos are supported by the routed model family. Seedance 2.5 accepts up to 10 aggregate video inputs; other video models retain the shared limit of 3 references unless the model details specify a lower limit.",
3668
3838
  "minItems": 1,
3669
- "maxItems": 3,
3839
+ "maxItems": 10,
3670
3840
  "items": {
3671
3841
  "type": "string",
3672
3842
  "format": "uri"
@@ -3674,9 +3844,9 @@
3674
3844
  },
3675
3845
  "audio_urls": {
3676
3846
  "type": "array",
3677
- "description": "Compatibility array for audio-conditioned flows when multiple audio references are supported by the routed model family. TokenLab currently accepts up to 3 reference audios.",
3847
+ "description": "Compatibility array for audio-conditioned flows when multiple audio references are supported by the routed model family. Seedance 2.5 accepts up to 10 aggregate audio inputs and permits pure-audio reference requests without a prompt; other video models retain the shared limit of 3 references unless the model details specify a lower limit.",
3678
3848
  "minItems": 1,
3679
- "maxItems": 3,
3849
+ "maxItems": 10,
3680
3850
  "items": {
3681
3851
  "type": "string",
3682
3852
  "format": "uri"
@@ -3728,16 +3898,16 @@
3728
3898
  "default",
3729
3899
  "flex"
3730
3900
  ],
3731
- "description": "Optional service tier for compatible video models. service_tier=default is accepted as a no-op for Seedance 2.0 models; service_tier=flex is rejected where the selected model does not support it."
3901
+ "description": "Optional service tier for compatible video models. service_tier=default is accepted as a compatibility no-op for Seedance 2.0 and Seedance 2.5; service_tier=flex is rejected for both models."
3732
3902
  },
3733
3903
  "frames": {
3734
3904
  "type": "integer",
3735
3905
  "minimum": 1,
3736
- "description": "Optional frame count for compatible video models. Seedance 2.0 models and Seedance 1.5 Pro do not support this field."
3906
+ "description": "Optional frame count for compatible video models. Seedance 1.5 Pro, Seedance 2.0, and Seedance 2.5 do not support this field."
3737
3907
  },
3738
3908
  "camera_fixed": {
3739
3909
  "type": "boolean",
3740
- "description": "Optional fixed-camera selector for compatible video models. Seedance 2.0 models do not support this field."
3910
+ "description": "Optional fixed-camera selector for compatible video models. Seedance 2.0 and Seedance 2.5 do not support this field."
3741
3911
  },
3742
3912
  "return_last_frame": {
3743
3913
  "type": "boolean",
@@ -3759,7 +3929,9 @@
3759
3929
  "bindings": {
3760
3930
  "path": [],
3761
3931
  "query": [],
3762
- "header": [],
3932
+ "header": [
3933
+ "X-TokenLab-Delivery-Policy"
3934
+ ],
3763
3935
  "body": [
3764
3936
  "prompt",
3765
3937
  "model",
@@ -3770,6 +3942,7 @@
3770
3942
  "duration",
3771
3943
  "aspect_ratio",
3772
3944
  "resolution",
3945
+ "output_format",
3773
3946
  "output_audio",
3774
3947
  "fps",
3775
3948
  "negative_prompt",
@@ -3853,6 +4026,15 @@
3853
4026
  "$schema": "http://json-schema.org/draft-07/schema#",
3854
4027
  "type": "object",
3855
4028
  "properties": {
4029
+ "X-TokenLab-Delivery-Policy": {
4030
+ "type": "string",
4031
+ "enum": [
4032
+ "auto",
4033
+ "verified",
4034
+ "official"
4035
+ ],
4036
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
4037
+ },
3856
4038
  "CallbackURL": {
3857
4039
  "type": "string",
3858
4040
  "format": "uri",
@@ -3875,7 +4057,9 @@
3875
4057
  "Action",
3876
4058
  "Version"
3877
4059
  ],
3878
- "header": [],
4060
+ "header": [
4061
+ "X-TokenLab-Delivery-Policy"
4062
+ ],
3879
4063
  "body": [
3880
4064
  "CallbackURL",
3881
4065
  "ProjectName"
@@ -3895,7 +4079,7 @@
3895
4079
  },
3896
4080
  {
3897
4081
  "name": "create_volc_compatible_seedance_task",
3898
- "title": "Create Seedance task (Volc-compatible)",
4082
+ "title": "Create Seedance task (Volc wire-compatible)",
3899
4083
  "operation_id": "createVolcCompatibleSeedanceTask",
3900
4084
  "method": "POST",
3901
4085
  "path": "/api/v3/contents/generations/tasks",
@@ -3907,11 +4091,26 @@
3907
4091
  "profiles": [
3908
4092
  "full"
3909
4093
  ],
3910
- "description": "Create Seedance task (Volc-compatible) Creates a Seedance 2.0 video generation task using a Volc-style REST body. Authentication uses a TokenLab Bearer API key.",
4094
+ "description": "Create Seedance task (Volc wire-compatible) Creates a Seedance 2.0 video task with the official Volc REST body and response shape. Authentication uses a TokenLab Bearer API key. TokenLab additionally accepts an optional Idempotency-Key header so a client can recover the same task ID after a lost create response.",
3911
4095
  "input_schema": {
3912
4096
  "$schema": "http://json-schema.org/draft-07/schema#",
3913
4097
  "type": "object",
3914
4098
  "properties": {
4099
+ "X-TokenLab-Delivery-Policy": {
4100
+ "type": "string",
4101
+ "enum": [
4102
+ "auto",
4103
+ "verified",
4104
+ "official"
4105
+ ],
4106
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
4107
+ },
4108
+ "Idempotency-Key": {
4109
+ "type": "string",
4110
+ "minLength": 1,
4111
+ "maxLength": 255,
4112
+ "description": "Client-generated key for idempotent REST task creation. Under the same TokenLab API credential, reusing the same key with the same JSON body returns the original cgt task ID; reusing it with a different body returns 409. Keep the credential, key, and request body unchanged when retrying after a timeout or disconnect."
4113
+ },
3915
4114
  "model": {
3916
4115
  "type": "string",
3917
4116
  "description": "Seedance model or endpoint identifier. TokenLab maps supported Seedance 2.0 identifiers to the matching platform model."
@@ -3919,6 +4118,7 @@
3919
4118
  "content": {
3920
4119
  "type": "array",
3921
4120
  "minItems": 1,
4121
+ "maxItems": 16,
3922
4122
  "items": {
3923
4123
  "type": "object",
3924
4124
  "description": "Volc-style content item. Use text, image_url, video_url, audio_url, or draft_task. For image_url, omitting role treats the image as first_frame; use role=reference_image for reference images.",
@@ -3952,100 +4152,61 @@
3952
4152
  "description": "Media role. first_frame/last_frame inputs cannot be mixed with reference_image/reference_video/reference_audio inputs."
3953
4153
  },
3954
4154
  "image_url": {
3955
- "oneOf": [
3956
- {
3957
- "type": "string",
3958
- "format": "uri"
3959
- },
3960
- {
3961
- "type": "object",
3962
- "required": [
3963
- "url"
3964
- ],
3965
- "properties": {
3966
- "url": {
3967
- "type": "string",
3968
- "format": "uri"
3969
- }
3970
- },
3971
- "additionalProperties": true
3972
- }
4155
+ "type": "object",
4156
+ "required": [
4157
+ "url"
3973
4158
  ],
3974
- "description": "Image reference. The object form {\"url\":\"https://...\"} matches the official request shape; a plain string is accepted for convenience. TokenLab also accepts asset://asset-YYYYMMDDHHMMSS-xxxxx URIs for ACTIVE materials owned by the requesting organization, and preserves the item's first_frame, last_frame, or reference_image role."
4159
+ "properties": {
4160
+ "url": {
4161
+ "type": "string"
4162
+ }
4163
+ },
4164
+ "additionalProperties": false,
4165
+ "description": "Image reference in the official {\"url\":\"https://...\"} shape. TokenLab material URIs remain available as URL values without changing the request object shape."
3975
4166
  },
3976
4167
  "video_url": {
3977
- "oneOf": [
3978
- {
3979
- "type": "string",
3980
- "format": "uri"
3981
- },
3982
- {
3983
- "type": "object",
3984
- "required": [
3985
- "url"
3986
- ],
3987
- "properties": {
3988
- "url": {
3989
- "type": "string",
3990
- "format": "uri"
3991
- }
3992
- },
3993
- "additionalProperties": true
3994
- }
4168
+ "type": "object",
4169
+ "required": [
4170
+ "url"
3995
4171
  ],
4172
+ "properties": {
4173
+ "url": {
4174
+ "type": "string"
4175
+ }
4176
+ },
4177
+ "additionalProperties": false,
3996
4178
  "description": "Video URL. Use role=reference_video."
3997
4179
  },
3998
4180
  "audio_url": {
3999
- "oneOf": [
4000
- {
4001
- "type": "string",
4002
- "format": "uri"
4003
- },
4004
- {
4005
- "type": "object",
4006
- "required": [
4007
- "url"
4008
- ],
4009
- "properties": {
4010
- "url": {
4011
- "type": "string",
4012
- "format": "uri"
4013
- }
4014
- },
4015
- "additionalProperties": true
4016
- }
4181
+ "type": "object",
4182
+ "required": [
4183
+ "url"
4017
4184
  ],
4185
+ "properties": {
4186
+ "url": {
4187
+ "type": "string"
4188
+ }
4189
+ },
4190
+ "additionalProperties": false,
4018
4191
  "description": "Audio URL. Use role=reference_audio."
4019
4192
  },
4020
4193
  "draft_task": {
4021
- "oneOf": [
4022
- {
4194
+ "type": "object",
4195
+ "required": [
4196
+ "id"
4197
+ ],
4198
+ "properties": {
4199
+ "id": {
4023
4200
  "type": "string"
4024
- },
4025
- {
4026
- "type": "object",
4027
- "required": [
4028
- "id"
4029
- ],
4030
- "properties": {
4031
- "id": {
4032
- "type": "string"
4033
- }
4034
- },
4035
- "additionalProperties": true
4036
4201
  }
4037
- ],
4038
- "description": "Draft task reference. The object form {\"id\":\"cgt-...\"} matches the official request shape."
4202
+ },
4203
+ "additionalProperties": false,
4204
+ "description": "Draft task reference in the official {\"id\":\"cgt-...\"} shape."
4039
4205
  }
4040
4206
  },
4041
- "additionalProperties": true
4042
- }
4043
- },
4044
- "material_asset_id": {
4045
- "type": "string",
4046
- "pattern": "^asset-\\d{14}-[a-z0-9]{5}$",
4047
- "maxLength": 128,
4048
- "description": "TokenLab compatibility shorthand for one ACTIVE Seedance material owned by the requesting organization. It is treated as the first frame and cannot be combined with other media inputs. For multiple materials, use content image_url items with explicit roles; top-level material_asset_ids is rejected as ambiguous."
4207
+ "additionalProperties": false
4208
+ },
4209
+ "description": "At most 16 content items: one text item, nine image_url items, three video_url items, three audio_url items, and one draft_task item. Model- and operation-specific combination rules still apply."
4049
4210
  },
4050
4211
  "ratio": {
4051
4212
  "type": "string",
@@ -4062,7 +4223,19 @@
4062
4223
  "description": "Output aspect ratio. Defaults to adaptive when omitted."
4063
4224
  },
4064
4225
  "duration": {
4065
- "type": "integer",
4226
+ "oneOf": [
4227
+ {
4228
+ "type": "integer",
4229
+ "enum": [
4230
+ -1
4231
+ ]
4232
+ },
4233
+ {
4234
+ "type": "integer",
4235
+ "minimum": 4,
4236
+ "maximum": 15
4237
+ }
4238
+ ],
4066
4239
  "default": 5,
4067
4240
  "description": "Video duration in seconds. Seedance 2.0 supports normal integer durations and -1 for automatic duration where the selected model supports it."
4068
4241
  },
@@ -4071,16 +4244,15 @@
4071
4244
  "enum": [
4072
4245
  "480p",
4073
4246
  "720p",
4074
- "1080p",
4075
- "4k"
4247
+ "1080p"
4076
4248
  ],
4077
4249
  "default": "720p",
4078
- "description": "Requested output resolution. 4k is only available on supported Seedance 2.0 routes; fast/mini availability depends on model capability."
4250
+ "description": "Requested output resolution. Model-specific availability still applies."
4079
4251
  },
4080
4252
  "generate_audio": {
4081
4253
  "type": "boolean",
4082
- "default": true,
4083
- "description": "Whether to generate audio. Defaults to true for Seedance 2.0 compatible requests."
4254
+ "default": false,
4255
+ "description": "Whether to generate synchronized audio. The official default is false."
4084
4256
  },
4085
4257
  "return_last_frame": {
4086
4258
  "type": "boolean",
@@ -4093,6 +4265,8 @@
4093
4265
  },
4094
4266
  "seed": {
4095
4267
  "type": "integer",
4268
+ "minimum": -1,
4269
+ "maximum": 4294967295,
4096
4270
  "default": -1,
4097
4271
  "description": "Random seed. -1 lets the model choose a seed. Forwarded on a best-effort basis for routes that accept it."
4098
4272
  },
@@ -4103,12 +4277,6 @@
4103
4277
  "default": 172800,
4104
4278
  "description": "Task execution expiration window in seconds."
4105
4279
  },
4106
- "priority": {
4107
- "type": "integer",
4108
- "default": 0,
4109
- "minimum": 0,
4110
- "maximum": 9
4111
- },
4112
4280
  "safety_identifier": {
4113
4281
  "type": "string",
4114
4282
  "maxLength": 64,
@@ -4125,9 +4293,21 @@
4125
4293
  },
4126
4294
  "tools": {
4127
4295
  "type": "array",
4296
+ "maxItems": 1,
4128
4297
  "items": {
4129
4298
  "type": "object",
4130
- "additionalProperties": true
4299
+ "required": [
4300
+ "type"
4301
+ ],
4302
+ "properties": {
4303
+ "type": {
4304
+ "type": "string",
4305
+ "enum": [
4306
+ "web_search"
4307
+ ]
4308
+ }
4309
+ },
4310
+ "additionalProperties": false
4131
4311
  },
4132
4312
  "description": "Optional tools such as {\"type\":\"web_search\"} when supported by the selected model."
4133
4313
  },
@@ -4146,7 +4326,8 @@
4146
4326
  "callback_url": {
4147
4327
  "type": "string",
4148
4328
  "format": "uri",
4149
- "description": "Not supported in this compatibility endpoint. Poll task status instead."
4329
+ "maxLength": 2048,
4330
+ "description": "Public HTTP(S) endpoint notified by POST whenever status changes. The body is identical to the get-task response. queued, running, succeeded, failed, and expired are delivered. For succeeded and failed, a delivery without success within 5 seconds is retried up to three times."
4150
4331
  }
4151
4332
  },
4152
4333
  "required": [
@@ -4158,11 +4339,13 @@
4158
4339
  "bindings": {
4159
4340
  "path": [],
4160
4341
  "query": [],
4161
- "header": [],
4342
+ "header": [
4343
+ "X-TokenLab-Delivery-Policy",
4344
+ "Idempotency-Key"
4345
+ ],
4162
4346
  "body": [
4163
4347
  "model",
4164
4348
  "content",
4165
- "material_asset_id",
4166
4349
  "ratio",
4167
4350
  "duration",
4168
4351
  "resolution",
@@ -4171,7 +4354,6 @@
4171
4354
  "watermark",
4172
4355
  "seed",
4173
4356
  "execution_expires_after",
4174
- "priority",
4175
4357
  "safety_identifier",
4176
4358
  "service_tier",
4177
4359
  "tools",
@@ -4208,6 +4390,15 @@
4208
4390
  "$schema": "http://json-schema.org/draft-07/schema#",
4209
4391
  "type": "object",
4210
4392
  "properties": {
4393
+ "X-TokenLab-Delivery-Policy": {
4394
+ "type": "string",
4395
+ "enum": [
4396
+ "auto",
4397
+ "verified",
4398
+ "official"
4399
+ ],
4400
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
4401
+ },
4211
4402
  "model": {
4212
4403
  "type": "string",
4213
4404
  "default": "marble-1.0",
@@ -4320,7 +4511,9 @@
4320
4511
  "bindings": {
4321
4512
  "path": [],
4322
4513
  "query": [],
4323
- "header": [],
4514
+ "header": [
4515
+ "X-TokenLab-Delivery-Policy"
4516
+ ],
4324
4517
  "body": [
4325
4518
  "model",
4326
4519
  "prompt",
@@ -4774,6 +4967,15 @@
4774
4967
  "$schema": "http://json-schema.org/draft-07/schema#",
4775
4968
  "type": "object",
4776
4969
  "properties": {
4970
+ "X-TokenLab-Delivery-Policy": {
4971
+ "type": "string",
4972
+ "enum": [
4973
+ "auto",
4974
+ "verified",
4975
+ "official"
4976
+ ],
4977
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
4978
+ },
4777
4979
  "Action": {
4778
4980
  "type": "string",
4779
4981
  "enum": [
@@ -4966,7 +5168,9 @@
4966
5168
  "Action",
4967
5169
  "Version"
4968
5170
  ],
4969
- "header": [],
5171
+ "header": [
5172
+ "X-TokenLab-Delivery-Policy"
5173
+ ],
4970
5174
  "body": [
4971
5175
  "body"
4972
5176
  ],
@@ -4999,6 +5203,15 @@
4999
5203
  "$schema": "http://json-schema.org/draft-07/schema#",
5000
5204
  "type": "object",
5001
5205
  "properties": {
5206
+ "X-TokenLab-Delivery-Policy": {
5207
+ "type": "string",
5208
+ "enum": [
5209
+ "auto",
5210
+ "verified",
5211
+ "official"
5212
+ ],
5213
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
5214
+ },
5002
5215
  "model": {
5003
5216
  "type": "string",
5004
5217
  "description": "Model to use for image edits. Send this explicitly."
@@ -5150,7 +5363,9 @@
5150
5363
  "bindings": {
5151
5364
  "path": [],
5152
5365
  "query": [],
5153
- "header": [],
5366
+ "header": [
5367
+ "X-TokenLab-Delivery-Policy"
5368
+ ],
5154
5369
  "body": [
5155
5370
  "model",
5156
5371
  "prompt",
@@ -5222,6 +5437,15 @@
5222
5437
  "$schema": "http://json-schema.org/draft-07/schema#",
5223
5438
  "type": "object",
5224
5439
  "properties": {
5440
+ "X-TokenLab-Delivery-Policy": {
5441
+ "type": "string",
5442
+ "enum": [
5443
+ "auto",
5444
+ "verified",
5445
+ "official"
5446
+ ],
5447
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
5448
+ },
5225
5449
  "image": {
5226
5450
  "oneOf": [
5227
5451
  {
@@ -5326,7 +5550,9 @@
5326
5550
  "bindings": {
5327
5551
  "path": [],
5328
5552
  "query": [],
5329
- "header": [],
5553
+ "header": [
5554
+ "X-TokenLab-Delivery-Policy"
5555
+ ],
5330
5556
  "body": [
5331
5557
  "image",
5332
5558
  "mask",
@@ -5400,6 +5626,15 @@
5400
5626
  "$schema": "http://json-schema.org/draft-07/schema#",
5401
5627
  "type": "object",
5402
5628
  "properties": {
5629
+ "X-TokenLab-Delivery-Policy": {
5630
+ "type": "string",
5631
+ "enum": [
5632
+ "auto",
5633
+ "verified",
5634
+ "official"
5635
+ ],
5636
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
5637
+ },
5403
5638
  "model": {
5404
5639
  "type": "string"
5405
5640
  },
@@ -5427,7 +5662,9 @@
5427
5662
  "query": [
5428
5663
  "key"
5429
5664
  ],
5430
- "header": [],
5665
+ "header": [
5666
+ "X-TokenLab-Delivery-Policy"
5667
+ ],
5431
5668
  "body": [
5432
5669
  "requests"
5433
5670
  ],
@@ -5527,6 +5764,15 @@
5527
5764
  "$schema": "http://json-schema.org/draft-07/schema#",
5528
5765
  "type": "object",
5529
5766
  "properties": {
5767
+ "X-TokenLab-Delivery-Policy": {
5768
+ "type": "string",
5769
+ "enum": [
5770
+ "auto",
5771
+ "verified",
5772
+ "official"
5773
+ ],
5774
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
5775
+ },
5530
5776
  "model": {
5531
5777
  "type": "string"
5532
5778
  },
@@ -5566,7 +5812,9 @@
5566
5812
  "query": [
5567
5813
  "key"
5568
5814
  ],
5569
- "header": [],
5815
+ "header": [
5816
+ "X-TokenLab-Delivery-Policy"
5817
+ ],
5570
5818
  "body": [
5571
5819
  "content",
5572
5820
  "taskType",
@@ -6138,6 +6386,15 @@
6138
6386
  "$schema": "http://json-schema.org/draft-07/schema#",
6139
6387
  "type": "object",
6140
6388
  "properties": {
6389
+ "X-TokenLab-Delivery-Policy": {
6390
+ "type": "string",
6391
+ "enum": [
6392
+ "auto",
6393
+ "verified",
6394
+ "official"
6395
+ ],
6396
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
6397
+ },
6141
6398
  "BytedToken": {
6142
6399
  "type": "string",
6143
6400
  "description": "Opaque token returned by CreateVisualValidateSession. It is valid for 30 minutes and scoped to the authenticated organization, actor, and ProjectName."
@@ -6159,7 +6416,9 @@
6159
6416
  "Action",
6160
6417
  "Version"
6161
6418
  ],
6162
- "header": [],
6419
+ "header": [
6420
+ "X-TokenLab-Delivery-Policy"
6421
+ ],
6163
6422
  "body": [
6164
6423
  "BytedToken",
6165
6424
  "ProjectName"
@@ -6875,6 +7134,7 @@
6875
7134
  "page_num": {
6876
7135
  "type": "integer",
6877
7136
  "minimum": 1,
7137
+ "maximum": 500,
6878
7138
  "default": 1,
6879
7139
  "description": "Page number."
6880
7140
  },
@@ -6898,8 +7158,11 @@
6898
7158
  "description": "Filter by task status."
6899
7159
  },
6900
7160
  "filter.task_ids": {
6901
- "type": "string",
6902
- "description": "Comma-separated task IDs."
7161
+ "type": "array",
7162
+ "items": {
7163
+ "type": "string"
7164
+ },
7165
+ "description": "Exact task IDs. Repeat filter.task_ids for multiple IDs."
6903
7166
  },
6904
7167
  "filter.model": {
6905
7168
  "type": "string",
@@ -6959,91 +7222,63 @@
6959
7222
  "default": 20
6960
7223
  },
6961
7224
  "page_token": {
6962
- "anyOf": [
6963
- {
6964
- "type": "string"
6965
- },
6966
- {
6967
- "type": "null"
6968
- }
7225
+ "type": [
7226
+ "string",
7227
+ "null"
6969
7228
  ]
6970
7229
  },
6971
7230
  "status": {
6972
- "anyOf": [
6973
- {
6974
- "type": "string",
6975
- "enum": [
6976
- "SUCCEEDED",
6977
- "PENDING",
6978
- "FAILED",
6979
- "RUNNING"
6980
- ]
6981
- },
6982
- {
6983
- "type": "null"
6984
- }
7231
+ "type": [
7232
+ "string",
7233
+ "null"
7234
+ ],
7235
+ "enum": [
7236
+ "SUCCEEDED",
7237
+ "PENDING",
7238
+ "FAILED",
7239
+ "RUNNING"
6985
7240
  ]
6986
7241
  },
6987
7242
  "model": {
6988
- "anyOf": [
6989
- {
6990
- "type": "string",
6991
- "enum": [
6992
- "marble-1.0",
6993
- "marble-1.1",
6994
- "marble-1.1-plus",
6995
- "marble-1.0-draft"
6996
- ]
6997
- },
6998
- {
6999
- "type": "null"
7000
- }
7243
+ "type": [
7244
+ "string",
7245
+ "null"
7246
+ ],
7247
+ "enum": [
7248
+ "marble-1.0",
7249
+ "marble-1.1",
7250
+ "marble-1.1-plus",
7251
+ "marble-1.0-draft"
7001
7252
  ]
7002
7253
  },
7003
7254
  "tags": {
7004
- "anyOf": [
7005
- {
7006
- "type": "array",
7007
- "items": {
7008
- "type": "string"
7009
- }
7010
- },
7011
- {
7012
- "type": "null"
7013
- }
7014
- ]
7255
+ "type": [
7256
+ "array",
7257
+ "null"
7258
+ ],
7259
+ "items": {
7260
+ "type": "string"
7261
+ }
7015
7262
  },
7016
7263
  "is_public": {
7017
- "anyOf": [
7018
- {
7019
- "type": "boolean"
7020
- },
7021
- {
7022
- "type": "null"
7023
- }
7264
+ "type": [
7265
+ "boolean",
7266
+ "null"
7024
7267
  ]
7025
7268
  },
7026
7269
  "created_after": {
7027
- "anyOf": [
7028
- {
7029
- "type": "string",
7030
- "format": "date-time"
7031
- },
7032
- {
7033
- "type": "null"
7034
- }
7035
- ]
7270
+ "type": [
7271
+ "string",
7272
+ "null"
7273
+ ],
7274
+ "format": "date-time"
7036
7275
  },
7037
7276
  "created_before": {
7038
- "anyOf": [
7039
- {
7040
- "type": "string",
7041
- "format": "date-time"
7042
- },
7043
- {
7044
- "type": "null"
7045
- }
7046
- ]
7277
+ "type": [
7278
+ "string",
7279
+ "null"
7280
+ ],
7281
+ "format": "date-time"
7047
7282
  },
7048
7283
  "sort_by": {
7049
7284
  "type": "string",
@@ -7123,27 +7358,19 @@
7123
7358
  "description": "High-level media type."
7124
7359
  },
7125
7360
  "extension": {
7126
- "anyOf": [
7127
- {
7128
- "type": "string",
7129
- "description": "File extension without dot, such as jpg, png, or mp4."
7130
- },
7131
- {
7132
- "type": "null"
7133
- }
7134
- ]
7361
+ "type": [
7362
+ "string",
7363
+ "null"
7364
+ ],
7365
+ "description": "File extension without dot, such as jpg, png, or mp4."
7135
7366
  },
7136
7367
  "metadata": {
7137
- "anyOf": [
7138
- {
7139
- "type": "object",
7140
- "additionalProperties": true,
7141
- "description": "Optional application metadata."
7142
- },
7143
- {
7144
- "type": "null"
7145
- }
7146
- ]
7368
+ "type": [
7369
+ "object",
7370
+ "null"
7371
+ ],
7372
+ "additionalProperties": true,
7373
+ "description": "Optional application metadata."
7147
7374
  }
7148
7375
  },
7149
7376
  "required": [
@@ -7191,6 +7418,15 @@
7191
7418
  "$schema": "http://json-schema.org/draft-07/schema#",
7192
7419
  "type": "object",
7193
7420
  "properties": {
7421
+ "X-TokenLab-Delivery-Policy": {
7422
+ "type": "string",
7423
+ "enum": [
7424
+ "auto",
7425
+ "verified",
7426
+ "official"
7427
+ ],
7428
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
7429
+ },
7194
7430
  "model": {
7195
7431
  "type": "string",
7196
7432
  "description": "Reranker model to use"
@@ -7224,7 +7460,9 @@
7224
7460
  "bindings": {
7225
7461
  "path": [],
7226
7462
  "query": [],
7227
- "header": [],
7463
+ "header": [
7464
+ "X-TokenLab-Delivery-Policy"
7465
+ ],
7228
7466
  "body": [
7229
7467
  "model",
7230
7468
  "query",
@@ -7559,6 +7797,15 @@
7559
7797
  "$schema": "http://json-schema.org/draft-07/schema#",
7560
7798
  "type": "object",
7561
7799
  "properties": {
7800
+ "X-TokenLab-Delivery-Policy": {
7801
+ "type": "string",
7802
+ "enum": [
7803
+ "auto",
7804
+ "verified",
7805
+ "official"
7806
+ ],
7807
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
7808
+ },
7562
7809
  "file": {
7563
7810
  "type": "string",
7564
7811
  "description": "Audio file to transcribe Pass local file path."
@@ -7614,7 +7861,9 @@
7614
7861
  "bindings": {
7615
7862
  "path": [],
7616
7863
  "query": [],
7617
- "header": [],
7864
+ "header": [
7865
+ "X-TokenLab-Delivery-Policy"
7866
+ ],
7618
7867
  "body": [
7619
7868
  "file",
7620
7869
  "model",
@@ -7655,6 +7904,15 @@
7655
7904
  "$schema": "http://json-schema.org/draft-07/schema#",
7656
7905
  "type": "object",
7657
7906
  "properties": {
7907
+ "X-TokenLab-Delivery-Policy": {
7908
+ "type": "string",
7909
+ "enum": [
7910
+ "auto",
7911
+ "verified",
7912
+ "official"
7913
+ ],
7914
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
7915
+ },
7658
7916
  "file": {
7659
7917
  "type": "string",
7660
7918
  "description": "Pass local file path."
@@ -7683,7 +7941,9 @@
7683
7941
  "bindings": {
7684
7942
  "path": [],
7685
7943
  "query": [],
7686
- "header": [],
7944
+ "header": [
7945
+ "X-TokenLab-Delivery-Policy"
7946
+ ],
7687
7947
  "body": [
7688
7948
  "file",
7689
7949
  "model",
@@ -7722,6 +7982,15 @@
7722
7982
  "$schema": "http://json-schema.org/draft-07/schema#",
7723
7983
  "type": "object",
7724
7984
  "properties": {
7985
+ "X-TokenLab-Delivery-Policy": {
7986
+ "type": "string",
7987
+ "enum": [
7988
+ "auto",
7989
+ "verified",
7990
+ "official"
7991
+ ],
7992
+ "description": "Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, upstream acceptance, or persistent resource creation."
7993
+ },
7725
7994
  "model": {
7726
7995
  "type": "string"
7727
7996
  },
@@ -7755,7 +8024,9 @@
7755
8024
  "bindings": {
7756
8025
  "path": [],
7757
8026
  "query": [],
7758
- "header": [],
8027
+ "header": [
8028
+ "X-TokenLab-Delivery-Policy"
8029
+ ],
7759
8030
  "body": [
7760
8031
  "model",
7761
8032
  "text",
@@ -7822,16 +8093,12 @@
7822
8093
  "default": "default"
7823
8094
  },
7824
8095
  "metadata": {
7825
- "anyOf": [
7826
- {
7827
- "type": "object",
7828
- "additionalProperties": true,
7829
- "description": "Updated client metadata stored with the material asset."
7830
- },
7831
- {
7832
- "type": "null"
7833
- }
7834
- ]
8096
+ "type": [
8097
+ "object",
8098
+ "null"
8099
+ ],
8100
+ "additionalProperties": true,
8101
+ "description": "Updated client metadata stored with the material asset."
7835
8102
  }
7836
8103
  },
7837
8104
  "required": [
@@ -7889,15 +8156,11 @@
7889
8156
  "maxLength": 128
7890
8157
  },
7891
8158
  "description": {
7892
- "anyOf": [
7893
- {
7894
- "type": "string",
7895
- "maxLength": 500
7896
- },
7897
- {
7898
- "type": "null"
7899
- }
7900
- ]
8159
+ "type": [
8160
+ "string",
8161
+ "null"
8162
+ ],
8163
+ "maxLength": 500
7901
8164
  },
7902
8165
  "project_name": {
7903
8166
  "type": "string",
@@ -7906,15 +8169,11 @@
7906
8169
  "default": "default"
7907
8170
  },
7908
8171
  "metadata": {
7909
- "anyOf": [
7910
- {
7911
- "type": "object",
7912
- "additionalProperties": true
7913
- },
7914
- {
7915
- "type": "null"
7916
- }
7917
- ]
8172
+ "type": [
8173
+ "object",
8174
+ "null"
8175
+ ],
8176
+ "additionalProperties": true
7918
8177
  }
7919
8178
  },
7920
8179
  "required": [