@henjicc/ai-sdk 0.2.8 → 0.4.0
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.
- package/CHANGELOG.md +157 -141
- package/README.md +497 -455
- package/dist/capabilities/embedding/bailian.d.ts +23 -0
- package/dist/capabilities/embedding/bailian.js +10 -0
- package/dist/capabilities/embedding/bigmodel.d.ts +9 -0
- package/dist/capabilities/embedding/bigmodel.js +5 -0
- package/dist/capabilities/embedding/index.d.ts +1 -0
- package/dist/capabilities/embedding/index.js +1 -0
- package/dist/capabilities/embedding/ppio.d.ts +7 -0
- package/dist/capabilities/embedding/ppio.js +5 -0
- package/dist/capabilities/embedding/siliconflow.d.ts +21 -0
- package/dist/capabilities/embedding/siliconflow.js +10 -0
- package/dist/capabilities/embedding/volcengine.d.ts +10 -0
- package/dist/capabilities/embedding/volcengine.js +6 -0
- package/dist/capabilities/rerank/bailian.d.ts +21 -0
- package/dist/capabilities/rerank/bailian.js +14 -0
- package/dist/capabilities/rerank/bigmodel.d.ts +9 -0
- package/dist/capabilities/rerank/bigmodel.js +5 -0
- package/dist/capabilities/rerank/index.d.ts +1 -0
- package/dist/capabilities/rerank/index.js +1 -0
- package/dist/capabilities/rerank/ppio.d.ts +7 -0
- package/dist/capabilities/rerank/ppio.js +5 -0
- package/dist/capabilities/rerank/siliconflow.d.ts +21 -0
- package/dist/capabilities/rerank/siliconflow.js +10 -0
- package/dist/capabilities/retrieval/http.d.ts +3 -0
- package/dist/capabilities/retrieval/http.js +48 -0
- package/dist/capabilities/retrieval/module.d.ts +11 -0
- package/dist/capabilities/retrieval/module.js +110 -0
- package/dist/capabilities/retrieval/types.d.ts +54 -0
- package/dist/capabilities/retrieval/types.js +1 -0
- package/dist/capabilities/retrieval/validation.d.ts +10 -0
- package/dist/capabilities/retrieval/validation.js +65 -0
- package/dist/capabilities/types.d.ts +1 -1
- package/dist/catalog/apimart/gpt-image-2.5.model.d.ts +2 -0
- package/dist/catalog/apimart/gpt-image-2.5.model.js +51 -0
- package/dist/catalog/fal/gpt-image-2.5.model.d.ts +2 -0
- package/dist/catalog/fal/gpt-image-2.5.model.js +53 -0
- package/dist/catalog/fal/ic-light-v2.model.js +9 -13
- package/dist/catalog/grsai/gpt-image-2.5.model.d.ts +2 -0
- package/dist/catalog/grsai/gpt-image-2.5.model.js +54 -0
- package/dist/catalog/grsai/gptImage25Sizes.d.ts +1 -0
- package/dist/catalog/grsai/gptImage25Sizes.js +76 -0
- package/dist/catalog/index.js +112 -104
- package/dist/catalog/kie/gpt-image-2.5.model.d.ts +2 -0
- package/dist/catalog/kie/gpt-image-2.5.model.js +38 -0
- package/dist/catalog/shared/gptImage25.d.ts +16 -0
- package/dist/catalog/shared/gptImage25.js +48 -0
- package/dist/catalog/shared/gptImage25Pricing.d.ts +12 -0
- package/dist/catalog/shared/gptImage25Pricing.js +508 -0
- package/dist/llm/defaults.d.ts +1 -1
- package/dist/llm/defaults.js +1 -1
- package/dist/llm/discovery.d.ts +2 -0
- package/dist/llm/discovery.js +16 -5
- package/dist/llm/modelCatalogEntries.js +32 -0
- package/dist/llm/providerPresets.d.ts +3 -1
- package/dist/llm/providerPresets.js +6 -3
- package/dist/llm/providerReasoningRequest.js +14 -1
- package/dist/llm/siliconflow/index.d.ts +21 -0
- package/dist/llm/siliconflow/index.js +32 -0
- package/dist/llm/siliconflow/preset.d.ts +6 -0
- package/dist/llm/siliconflow/preset.js +33 -0
- package/dist/packs/models/apimart/gpt-image-2.5.d.ts +6 -0
- package/dist/packs/models/apimart/gpt-image-2.5.js +7 -0
- package/dist/packs/models/fal/gpt-image-2.5.d.ts +6 -0
- package/dist/packs/models/fal/gpt-image-2.5.js +7 -0
- package/dist/packs/models/grsai/gpt-image-2.5.d.ts +6 -0
- package/dist/packs/models/grsai/gpt-image-2.5.js +7 -0
- package/dist/packs/models/kie/gpt-image-2.5.d.ts +6 -0
- package/dist/packs/models/kie/gpt-image-2.5.js +7 -0
- package/dist/packs/provider-packs/apimart.d.ts +1 -1
- package/dist/packs/provider-packs/apimart.js +21 -20
- package/dist/packs/provider-packs/fal.d.ts +1 -1
- package/dist/packs/provider-packs/fal.js +37 -36
- package/dist/packs/provider-packs/grsai.d.ts +1 -1
- package/dist/packs/provider-packs/grsai.js +6 -5
- package/dist/packs/provider-packs/kie.d.ts +1 -1
- package/dist/packs/provider-packs/kie.js +28 -27
- package/dist/packs/tool-models/fal/{qwen-image-edit-2509-multiple-angles.d.ts → qwen-image-edit-2511-multiple-angles.d.ts} +1 -1
- package/dist/packs/tool-models/fal/{qwen-image-edit-2509-multiple-angles.js → qwen-image-edit-2511-multiple-angles.js} +1 -1
- package/dist/packs/tool-packs/fal-multi-angle-tools.js +1 -1
- package/dist/tool-packs/fal-multi-angle/models/qwen-image-edit-2511-multiple-angles.model.d.ts +2 -0
- package/dist/tool-packs/fal-multi-angle/models/{qwen-image-edit-2509-multiple-angles.model.js → qwen-image-edit-2511-multiple-angles.model.js} +20 -17
- package/docs/README.md +26 -26
- package/docs/consumers.md +56 -48
- package/docs/llm-adaptation/README.md +139 -137
- package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/DeepSeek.md +103 -91
- package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/Kimi.md +75 -75
- package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/MiniMax.md +84 -84
- package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//345/260/217/347/261/263MiMo.md +85 -85
- package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//346/231/272/350/260/261GLM.md +232 -232
- package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//347/201/253/345/261/261/345/274/225/346/223/216.md +87 -87
- package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//347/231/276/347/202/274Qwen.md +84 -84
- package/docs/llm-adaptation//346/226/207/346/241/243/351/207/207/351/233/206/346/211/213/345/206/214.md +88 -88
- package/docs/model-adaptation/Bria-Eraser/Bria-Eraser_Fal.md +32 -32
- package/docs/model-adaptation/Bria-/345/210/233/346/204/217/346/224/276/345/244/247/Bria-/345/210/233/346/204/217/346/224/276/345/244/247_Fal.md +31 -31
- package/docs/model-adaptation/ControlLight/ControlLight_Fal.md +85 -85
- package/docs/model-adaptation/FLUX-2-/345/244/232/350/247/222/345/272/246/FLUX-2-/345/244/232/350/247/222/345/272/246_Fal.md +107 -107
- package/docs/model-adaptation/Finegrain-Eraser/Finegrain-Eraser_Fal.md +31 -31
- package/docs/model-adaptation/Flux-Pro-Erase/Flux-Pro-Erase_Fal.md +34 -34
- package/docs/model-adaptation/Fun-ASR/Fun-ASR_/347/231/276/347/202/274.md +43 -43
- package/docs/model-adaptation/Fun-ASR-Flash-2026-06-15/Fun-ASR-Flash-2026-06-15_/347/231/276/347/202/274.md +41 -41
- package/docs/model-adaptation/Fun-ASR-Realtime/Fun-ASR-Realtime_/347/231/276/347/202/274.md +37 -37
- package/docs/model-adaptation/Fun-ASR-Realtime-2026-02-28/Fun-ASR-Realtime-2026-02-28_/347/231/276/347/202/274.md +39 -39
- package/docs/model-adaptation/GLM-5.3-Flash/GLM-5.3-Flash_/346/231/272/350/260/261.md +207 -207
- package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_APIMart.md +173 -173
- package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_Fal.md +94 -94
- package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_Grsai.md +137 -137
- package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_KIE.md +93 -93
- package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_APIMart.md +66 -0
- package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_Fal.md +55 -0
- package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_Grsai.md +53 -0
- package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_KIE.md +55 -0
- package/docs/model-adaptation/GPT-OSS-20B/GPT-OSS-20B_Groq.md +62 -62
- package/docs/model-adaptation/Gemini-Omni-Flash/Gemini-Omni-Flash_APIMart.md +124 -124
- package/docs/model-adaptation/Gemini-Omni-Flash/Gemini-Omni-Flash_Fal.md +84 -84
- package/docs/model-adaptation/Gemini-Omni-Flash/Gemini-Omni-Flash_KIE.md +129 -129
- package/docs/model-adaptation/Grok-Imagine/Grok-Imagine_KIE.md +36 -36
- package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_APIMart.md +250 -250
- package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_Fal.md +84 -84
- package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_KIE.md +105 -105
- package/docs/model-adaptation/Hailuo-02/Hailuo-02_Fal.md +93 -93
- package/docs/model-adaptation/Hailuo-02/Hailuo-02_KIE.md +56 -56
- package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_Fal.md +88 -88
- package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_KIE.md +51 -51
- package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_/346/264/276/346/254/247/344/272/221.md +70 -70
- package/docs/model-adaptation/IC-Light-v2/IC-Light-v2_Fal.md +97 -94
- package/docs/model-adaptation/Ideogram-/345/233/276/347/211/207/346/224/276/345/244/247/Ideogram-/345/233/276/347/211/207/346/224/276/345/244/247_Fal.md +41 -41
- package/docs/model-adaptation/Image-Apps-v2-/345/225/206/345/223/201/346/221/204/345/275/261/Image-Apps-v2-/345/225/206/345/223/201/346/221/204/345/275/261_Fal.md +72 -72
- package/docs/model-adaptation/Image-Apps-v2-/346/211/251/345/233/276/Image-Apps-v2-/346/211/251/345/233/276_Fal.md +93 -93
- package/docs/model-adaptation/Image-Apps-v2-/347/205/247/347/211/207/344/277/256/345/244/215/Image-Apps-v2-/347/205/247/347/211/207/344/277/256/345/244/215_Fal.md +86 -86
- package/docs/model-adaptation/Image-Apps-v2-/351/207/215/346/211/223/345/205/211/Image-Apps-v2-/351/207/215/346/211/223/345/205/211_Fal.md +84 -84
- package/docs/model-adaptation/Kling-3.0/Kling-3.0_APIMart.md +112 -112
- package/docs/model-adaptation/Kling-3.0/Kling-3.0_Fal.md +89 -89
- package/docs/model-adaptation/Kling-3.0/Kling-3.0_KIE.md +106 -106
- package/docs/model-adaptation/Kling-3.0/Kling-3.0_/346/264/276/346/254/247/344/272/221.md +119 -119
- package/docs/model-adaptation/Kling-3.0-Omni/Kling-3.0-Omni_APIMart.md +125 -125
- package/docs/model-adaptation/Kling-3.0-Omni/Kling-3.0-Omni_Fal.md +107 -107
- package/docs/model-adaptation/Kling-3.0-Omni/Kling-3.0-Omni_KIE.md +143 -143
- package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_APIMart.md +85 -85
- package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_Fal.md +83 -83
- package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_KIE.md +84 -84
- package/docs/model-adaptation/Midjourney/Midjourney_APIMart.md +396 -396
- package/docs/model-adaptation/MiniMax-H3/MiniMax-H3_APIMart.md +234 -234
- package/docs/model-adaptation/MiniMax-H3/MiniMax-H3_Fal.md +108 -108
- package/docs/model-adaptation/MiniMax-H3/MiniMax-H3_KIE.md +111 -111
- package/docs/model-adaptation/MiniMax-Speech/MiniMax-Speech_/346/264/276/346/254/247/344/272/221.md +170 -170
- package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_APIMart.md +89 -89
- package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_Fal.md +99 -99
- package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_Grsai.md +82 -82
- package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_KIE.md +70 -70
- package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_APIMart.md +79 -79
- package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md +65 -65
- package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_KIE.md +64 -64
- package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_APIMart.md +83 -83
- package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_Fal.md +89 -89
- package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_Grsai.md +82 -82
- package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_KIE.md +64 -64
- package/docs/model-adaptation/Pixelcut-/350/203/214/346/231/257/347/247/273/351/231/244/Pixelcut-/350/203/214/346/231/257/347/247/273/351/231/244_Fal.md +79 -79
- package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_APIMart.md +117 -117
- package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_Fal.md +84 -84
- package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_KIE.md +103 -103
- package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_/347/231/276/347/202/274.md +138 -138
- package/docs/model-adaptation/Qwen-Image-Edit-2511-/345/244/232/350/247/222/345/272/246/Qwen-Image-Edit-2511-/345/244/232/350/247/222/345/272/246_Fal.md +57 -0
- package/docs/model-adaptation/Qwen-MT-Flash/Qwen-MT-Flash_/347/231/276/347/202/274.md +47 -47
- package/docs/model-adaptation/Qwen-MT-Lite/Qwen-MT-Lite_/347/231/276/347/202/274.md +39 -39
- package/docs/model-adaptation/Qwen-MT-Plus/Qwen-MT-Plus_/347/231/276/347/202/274.md +39 -39
- package/docs/model-adaptation/Qwen3-ASR-Flash/Qwen3-ASR-Flash_/347/231/276/347/202/274.md +40 -40
- package/docs/model-adaptation/Qwen3-ASR-Flash-2026-02-10/Qwen3-ASR-Flash-2026-02-10_/347/231/276/347/202/274.md +33 -33
- package/docs/model-adaptation/Qwen3-ASR-Flash-Filetrans/Qwen3-ASR-Flash-Filetrans_/347/231/276/347/202/274.md +41 -41
- package/docs/model-adaptation/Qwen3-ASR-Flash-Realtime/Qwen3-ASR-Flash-Realtime_/347/231/276/347/202/274.md +35 -35
- package/docs/model-adaptation/Qwen3-ASR-Flash-Realtime-2026-02-10/Qwen3-ASR-Flash-Realtime-2026-02-10_/347/231/276/347/202/274.md +37 -37
- package/docs/model-adaptation/README.md +313 -295
- package/docs/model-adaptation/SeedASR-2.0-File/SeedASR-2.0-File_/347/201/253/345/261/261/345/274/225/346/223/216.md +115 -115
- package/docs/model-adaptation/SeedASR-2.0-Realtime/SeedASR-2.0-Realtime_/347/201/253/345/261/261/345/274/225/346/223/216.md +143 -143
- package/docs/model-adaptation/SeedVR2-/345/233/276/347/211/207/346/224/276/345/244/247/SeedVR2-/345/233/276/347/211/207/346/224/276/345/244/247_Fal.md +45 -45
- package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_APIMart.md +121 -121
- package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_Fal.md +97 -97
- package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_KIE.md +86 -86
- package/docs/model-adaptation/Seedance-2.0-Fast/Seedance-2.0-Fast_APIMart.md +89 -89
- package/docs/model-adaptation/Seedance-2.0-Fast/Seedance-2.0-Fast_Fal.md +95 -95
- package/docs/model-adaptation/Seedance-2.0-Fast/Seedance-2.0-Fast_KIE.md +78 -78
- package/docs/model-adaptation/Seedance-2.0-Mini/Seedance-2.0-Mini_APIMart.md +89 -89
- package/docs/model-adaptation/Seedance-2.0-Mini/Seedance-2.0-Mini_Fal.md +96 -96
- package/docs/model-adaptation/Seedance-2.0-Mini/Seedance-2.0-Mini_KIE.md +78 -78
- package/docs/model-adaptation/Seedance-2.5/Seedance-2.5_APIMart.md +212 -212
- package/docs/model-adaptation/Seedance-2.5/Seedance-2.5_Fal.md +94 -94
- package/docs/model-adaptation/Seedance-2.5/Seedance-2.5_KIE.md +89 -89
- package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_APIMart.md +106 -106
- package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_Fal.md +91 -91
- package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_KIE.md +89 -89
- package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_/347/201/253/345/261/261/345/274/225/346/223/216.md +108 -108
- package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_APIMart.md +194 -194
- package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_Fal.md +100 -100
- package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_KIE.md +141 -141
- package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_/347/201/253/345/261/261/345/274/225/346/223/216.md +137 -137
- package/docs/model-adaptation/SenseVoiceSmall/SenseVoiceSmall_/347/241/205/345/237/272/346/265/201/345/212/250.md +69 -69
- package/docs/model-adaptation/TeleSpeechASR/TeleSpeechASR_/347/241/205/345/237/272/346/265/201/345/212/250.md +72 -72
- package/docs/model-adaptation/Topaz-/345/233/276/347/211/207/346/224/276/345/244/247/Topaz-/345/233/276/347/211/207/346/224/276/345/244/247_Fal.md +87 -87
- package/docs/model-adaptation/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247_Fal.md +34 -34
- package/docs/model-adaptation/Wan-2.5-Preview/Wan-2.5-Preview_/346/264/276/346/254/247/344/272/221.md +82 -82
- package/docs/model-adaptation/Wan-2.6/Wan-2.6_/346/264/276/346/254/247/344/272/221.md +84 -84
- package/docs/model-adaptation/Wan-2.7/Wan-2.7_/346/264/276/346/254/247/344/272/221.md +122 -122
- package/docs/model-adaptation/Whisper-Large-v3/Whisper-Large-v3_Groq.md +76 -76
- package/docs/model-adaptation/Whisper-Large-v3-Turbo/Whisper-Large-v3-Turbo_Groq.md +75 -75
- package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_APIMart.md +88 -88
- package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_Fal.md +95 -95
- package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_KIE.md +71 -71
- package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_/347/231/276/347/202/274.md +122 -122
- package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_/351/255/224/346/220/255.md +97 -97
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/APIMart.md +238 -238
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/Fal.md +172 -172
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/Groq.md +121 -121
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/Grsai.md +217 -217
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/KIE.md +131 -131
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//345/200/231/351/200/211/344/276/233/345/272/224/345/225/206/350/260/203/347/240/224-/345/233/276/347/211/207/345/267/245/345/205/267.md +151 -151
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//345/277/253/351/200/237/351/200/202/351/205/215/344/276/233/345/272/224/345/225/206.md +65 -65
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//346/264/276/346/254/247/344/272/221.md +147 -138
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//347/201/253/345/261/261/345/274/225/346/223/216.md +181 -171
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//347/231/276/347/202/274.md +237 -227
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//347/241/205/345/237/272/346/265/201/345/212/250.md +140 -75
- package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//351/255/224/346/220/255.md +207 -207
- package/docs/model-adaptation//346/226/207/346/241/243/351/207/207/351/233/206/346/211/213/345/206/214.md +338 -311
- package/docs/model-adaptation//351/200/217/350/247/206/345/217/230/346/215/242//351/200/217/350/247/206/345/217/230/346/215/242_Fal.md +59 -59
- package/docs//346/216/245/345/205/245/346/214/207/345/215/227/Electron.md +77 -77
- package/docs//346/216/245/345/205/245/346/214/207/345/215/227/Tauri.md +81 -81
- package/docs//346/216/245/345/205/245/346/214/207/345/215/227/UXP.md +169 -169
- package/docs//346/216/245/345/205/245/346/214/207/345/215/227//344/276/233/345/272/224/345/225/206/345/237/237/345/220/215.md +83 -83
- package/docs//346/216/245/345/205/245/346/214/207/345/215/227//351/224/231/350/257/257/345/244/204/347/220/206.md +72 -72
- package/examples/form-renderer/README.md +17 -17
- package/examples/form-renderer/cli.ts +32 -32
- package/examples/form-renderer/index.ts +144 -144
- package/examples/form-renderer/package.json +16 -16
- package/examples/form-renderer/tsconfig.json +14 -14
- package/examples/llm-chat/README.md +32 -32
- package/examples/llm-chat/index.ts +100 -100
- package/examples/llm-chat/package.json +19 -19
- package/examples/llm-chat/tsconfig.json +14 -14
- package/examples/minimal-node/README.md +31 -31
- package/examples/minimal-node/index.ts +138 -138
- package/examples/minimal-node/package.json +17 -17
- package/examples/minimal-node/tsconfig.json +14 -14
- package/package.json +255 -195
- package/dist/tool-packs/fal-multi-angle/models/qwen-image-edit-2509-multiple-angles.model.d.ts +0 -2
- package/docs/model-adaptation/Qwen-Image-Edit-2509-/345/244/232/350/247/222/345/272/246/Qwen-Image-Edit-2509-/345/244/232/350/247/222/345/272/246_Fal.md +0 -116
|
@@ -1,89 +1,89 @@
|
|
|
1
|
-
# Seedream 5.0 Lite · KIE
|
|
2
|
-
|
|
3
|
-
| 项目 | 内容 |
|
|
4
|
-
|---|---|
|
|
5
|
-
| 最后更新 | 2026-08-22 |
|
|
6
|
-
| 模态 | 图片 |
|
|
7
|
-
| 供应商 | KIE.ai(聚合平台) |
|
|
8
|
-
| 平台模型 ID | `seedream/5-lite-text-to-image`、`seedream/5-lite-image-to-image` |
|
|
9
|
-
| 接口形态 | **异步任务**(`createTask` + `recordInfo`) |
|
|
10
|
-
| 文档可见性 | 公开,无需登录 |
|
|
11
|
-
| 价格可见性 | 公开,无需登录 |
|
|
12
|
-
|
|
13
|
-
## 1. 接入协议
|
|
14
|
-
|
|
15
|
-
- **Base URL**:`https://api.kie.ai`
|
|
16
|
-
- **鉴权**:`Authorization: Bearer <API_KEY>`
|
|
17
|
-
- **提交**:`POST /api/v1/jobs/createTask`,体为 `{ model, callBackUrl?, input }`
|
|
18
|
-
- **查询**:`GET /api/v1/jobs/recordInfo?taskId=...`
|
|
19
|
-
- **终态**:`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`;成功后 `JSON.parse(resultJson)` 取 `resultUrls`
|
|
20
|
-
- **失败**:读 `failCode` / `failMsg`
|
|
21
|
-
|
|
22
|
-
## 2. 能力清单
|
|
23
|
-
|
|
24
|
-
| 能力 | model |
|
|
25
|
-
|---|---|
|
|
26
|
-
| 文生图 | `seedream/5-lite-text-to-image` |
|
|
27
|
-
| 图片编辑 / 多参考图 | `seedream/5-lite-image-to-image` |
|
|
28
|
-
|
|
29
|
-
> KIE 上的 Seedream 5.0 Lite **没有组图(sequential)专用端点**,`input` 中也没有数量字段——单次请求出 1 张。需要组图请走火山引擎官方或 APIMart。
|
|
30
|
-
|
|
31
|
-
## 3. 请求参数
|
|
32
|
-
|
|
33
|
-
### 3.1 `seedream/5-lite-text-to-image`
|
|
34
|
-
|
|
35
|
-
| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
|
|
36
|
-
|---|---|---|---|---|
|
|
37
|
-
| `input.prompt` | string | 必填 | — | 3–3000 字符 |
|
|
38
|
-
| `input.aspect_ratio` | string | 必填 | `1:1` | `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`2:3`、`3:2`、`21:9` |
|
|
39
|
-
| `input.quality` | string | 必填 | `basic` | **`basic` = 2K,`high` = 3K,`ultra` = 4K** |
|
|
40
|
-
| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
|
|
41
|
-
| `input.nsfw_checker` | boolean | 可选 | `false` | 设 `false` 关闭内容过滤;平台声明不保证全部过滤 |
|
|
42
|
-
|
|
43
|
-
### 3.2 `seedream/5-lite-image-to-image`
|
|
44
|
-
|
|
45
|
-
| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
|
|
46
|
-
|---|---|---|---|---|
|
|
47
|
-
| `input.prompt` | string | 必填 | — | 3–3000 字符 |
|
|
48
|
-
| `input.image_urls` | array | 必填 | — | **最多 14 张**。传上传后的文件 URL;支持 image/jpeg、image/png、image/webp;单张 ≤ 30 MB |
|
|
49
|
-
| `input.aspect_ratio` | string | 必填 | `1:1` | 同上 8 个比例 |
|
|
50
|
-
| `input.quality` | string | 必填 | `basic` | `basic` = 2K,`high` = 3K,`ultra` = 4K |
|
|
51
|
-
| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
|
|
52
|
-
| `input.nsfw_checker` | boolean | 可选 | `false` | 同上 |
|
|
53
|
-
|
|
54
|
-
> 参考图上限 **14 张**(Pro 是 10 张),与火山官方 Lite 的 14 张一致。
|
|
55
|
-
|
|
56
|
-
## 4. 响应结构
|
|
57
|
-
|
|
58
|
-
`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
|
|
59
|
-
|
|
60
|
-
## 5. 价格
|
|
61
|
-
|
|
62
|
-
来源:[KIE 定价页](https://kie.ai/pricing)(2026-08-22 读取,搜索 `seedream 5.0 Lite`;1 Credit = $0.005)。
|
|
63
|
-
|
|
64
|
-
| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
|
|
65
|
-
|---|---|---|---|
|
|
66
|
-
| 文生图 | 5.5 /张 | **$0.0275/张** | $0.035 |
|
|
67
|
-
| 图片编辑 | 5.5 /张 | **$0.0275/张** | $0.035 |
|
|
68
|
-
|
|
69
|
-
KIE 的 Lite 价格不分 2K/3K/4K 档位,统一单价。
|
|
70
|
-
|
|
71
|
-
## 6. 适配要点
|
|
72
|
-
|
|
73
|
-
- 本项目默认**绝对不显示**:`seed`、负面提示词。本接口无这两个字段。
|
|
74
|
-
- `output_format` 默认不显示、不请求。
|
|
75
|
-
- **`quality` 的语义在 Lite 与 Pro 完全不同**:Lite 是 `basic/high/ultra` → 2K/3K/4K,Pro 是 `basic/high` → 1K/2K。不能共用映射。
|
|
76
|
-
- 无参考图走 `text-to-image`,1–14 张走 `image-to-image`,在同一模型下路由。
|
|
77
|
-
- `resultJson` 是 JSON 字符串,必须二次 parse。
|
|
78
|
-
|
|
79
|
-
## 7. 原始链接索引
|
|
80
|
-
|
|
81
|
-
| 信息 | 链接 | 是否需登录 |
|
|
82
|
-
|---|---|---|
|
|
83
|
-
| Seedream 5.0 Lite 文生图 | https://docs.kie.ai/cn/market/seedream/5-lite-text-to-image | 否 |
|
|
84
|
-
| Seedream 5.0 Lite 图片编辑 | https://docs.kie.ai/cn/market/seedream/5-lite-image-to-image | 否 |
|
|
85
|
-
| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
|
|
86
|
-
| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
|
|
87
|
-
| 文件上传 | https://docs.kie.ai/cn/file-upload-api/upload-file-url | 否 |
|
|
88
|
-
| 定价页(搜 `seedream 5.0 Lite`) | https://kie.ai/pricing | 否 |
|
|
89
|
-
| API Key 管理 | https://kie.ai/api-key | **是** |
|
|
1
|
+
# Seedream 5.0 Lite · KIE
|
|
2
|
+
|
|
3
|
+
| 项目 | 内容 |
|
|
4
|
+
|---|---|
|
|
5
|
+
| 最后更新 | 2026-08-22 |
|
|
6
|
+
| 模态 | 图片 |
|
|
7
|
+
| 供应商 | KIE.ai(聚合平台) |
|
|
8
|
+
| 平台模型 ID | `seedream/5-lite-text-to-image`、`seedream/5-lite-image-to-image` |
|
|
9
|
+
| 接口形态 | **异步任务**(`createTask` + `recordInfo`) |
|
|
10
|
+
| 文档可见性 | 公开,无需登录 |
|
|
11
|
+
| 价格可见性 | 公开,无需登录 |
|
|
12
|
+
|
|
13
|
+
## 1. 接入协议
|
|
14
|
+
|
|
15
|
+
- **Base URL**:`https://api.kie.ai`
|
|
16
|
+
- **鉴权**:`Authorization: Bearer <API_KEY>`
|
|
17
|
+
- **提交**:`POST /api/v1/jobs/createTask`,体为 `{ model, callBackUrl?, input }`
|
|
18
|
+
- **查询**:`GET /api/v1/jobs/recordInfo?taskId=...`
|
|
19
|
+
- **终态**:`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`;成功后 `JSON.parse(resultJson)` 取 `resultUrls`
|
|
20
|
+
- **失败**:读 `failCode` / `failMsg`
|
|
21
|
+
|
|
22
|
+
## 2. 能力清单
|
|
23
|
+
|
|
24
|
+
| 能力 | model |
|
|
25
|
+
|---|---|
|
|
26
|
+
| 文生图 | `seedream/5-lite-text-to-image` |
|
|
27
|
+
| 图片编辑 / 多参考图 | `seedream/5-lite-image-to-image` |
|
|
28
|
+
|
|
29
|
+
> KIE 上的 Seedream 5.0 Lite **没有组图(sequential)专用端点**,`input` 中也没有数量字段——单次请求出 1 张。需要组图请走火山引擎官方或 APIMart。
|
|
30
|
+
|
|
31
|
+
## 3. 请求参数
|
|
32
|
+
|
|
33
|
+
### 3.1 `seedream/5-lite-text-to-image`
|
|
34
|
+
|
|
35
|
+
| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
|
|
36
|
+
|---|---|---|---|---|
|
|
37
|
+
| `input.prompt` | string | 必填 | — | 3–3000 字符 |
|
|
38
|
+
| `input.aspect_ratio` | string | 必填 | `1:1` | `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`2:3`、`3:2`、`21:9` |
|
|
39
|
+
| `input.quality` | string | 必填 | `basic` | **`basic` = 2K,`high` = 3K,`ultra` = 4K** |
|
|
40
|
+
| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
|
|
41
|
+
| `input.nsfw_checker` | boolean | 可选 | `false` | 设 `false` 关闭内容过滤;平台声明不保证全部过滤 |
|
|
42
|
+
|
|
43
|
+
### 3.2 `seedream/5-lite-image-to-image`
|
|
44
|
+
|
|
45
|
+
| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
|
|
46
|
+
|---|---|---|---|---|
|
|
47
|
+
| `input.prompt` | string | 必填 | — | 3–3000 字符 |
|
|
48
|
+
| `input.image_urls` | array | 必填 | — | **最多 14 张**。传上传后的文件 URL;支持 image/jpeg、image/png、image/webp;单张 ≤ 30 MB |
|
|
49
|
+
| `input.aspect_ratio` | string | 必填 | `1:1` | 同上 8 个比例 |
|
|
50
|
+
| `input.quality` | string | 必填 | `basic` | `basic` = 2K,`high` = 3K,`ultra` = 4K |
|
|
51
|
+
| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
|
|
52
|
+
| `input.nsfw_checker` | boolean | 可选 | `false` | 同上 |
|
|
53
|
+
|
|
54
|
+
> 参考图上限 **14 张**(Pro 是 10 张),与火山官方 Lite 的 14 张一致。
|
|
55
|
+
|
|
56
|
+
## 4. 响应结构
|
|
57
|
+
|
|
58
|
+
`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
|
|
59
|
+
|
|
60
|
+
## 5. 价格
|
|
61
|
+
|
|
62
|
+
来源:[KIE 定价页](https://kie.ai/pricing)(2026-08-22 读取,搜索 `seedream 5.0 Lite`;1 Credit = $0.005)。
|
|
63
|
+
|
|
64
|
+
| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
|
|
65
|
+
|---|---|---|---|
|
|
66
|
+
| 文生图 | 5.5 /张 | **$0.0275/张** | $0.035 |
|
|
67
|
+
| 图片编辑 | 5.5 /张 | **$0.0275/张** | $0.035 |
|
|
68
|
+
|
|
69
|
+
KIE 的 Lite 价格不分 2K/3K/4K 档位,统一单价。
|
|
70
|
+
|
|
71
|
+
## 6. 适配要点
|
|
72
|
+
|
|
73
|
+
- 本项目默认**绝对不显示**:`seed`、负面提示词。本接口无这两个字段。
|
|
74
|
+
- `output_format` 默认不显示、不请求。
|
|
75
|
+
- **`quality` 的语义在 Lite 与 Pro 完全不同**:Lite 是 `basic/high/ultra` → 2K/3K/4K,Pro 是 `basic/high` → 1K/2K。不能共用映射。
|
|
76
|
+
- 无参考图走 `text-to-image`,1–14 张走 `image-to-image`,在同一模型下路由。
|
|
77
|
+
- `resultJson` 是 JSON 字符串,必须二次 parse。
|
|
78
|
+
|
|
79
|
+
## 7. 原始链接索引
|
|
80
|
+
|
|
81
|
+
| 信息 | 链接 | 是否需登录 |
|
|
82
|
+
|---|---|---|
|
|
83
|
+
| Seedream 5.0 Lite 文生图 | https://docs.kie.ai/cn/market/seedream/5-lite-text-to-image | 否 |
|
|
84
|
+
| Seedream 5.0 Lite 图片编辑 | https://docs.kie.ai/cn/market/seedream/5-lite-image-to-image | 否 |
|
|
85
|
+
| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
|
|
86
|
+
| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
|
|
87
|
+
| 文件上传 | https://docs.kie.ai/cn/file-upload-api/upload-file-url | 否 |
|
|
88
|
+
| 定价页(搜 `seedream 5.0 Lite`) | https://kie.ai/pricing | 否 |
|
|
89
|
+
| API Key 管理 | https://kie.ai/api-key | **是** |
|
|
@@ -1,108 +1,108 @@
|
|
|
1
|
-
# Seedream 5.0 Lite · 火山引擎(火山方舟,官方)
|
|
2
|
-
|
|
3
|
-
| 项目 | 内容 |
|
|
4
|
-
|---|---|
|
|
5
|
-
| 最后更新 | 2026-08-30 |
|
|
6
|
-
| 模态 | 图片 |
|
|
7
|
-
| 供应商 | 火山引擎 · 火山方舟(Ark),模型原厂官方接口 |
|
|
8
|
-
| 平台模型 ID | `doubao-seedream-5-0-260128`(同时支持写作 `doubao-seedream-5-0-lite-260128`) |
|
|
9
|
-
| 接口形态 | **同步**,可选流式(`stream: true`) |
|
|
10
|
-
| 文档可见性 | 公开,无需登录;调用需 API Key |
|
|
11
|
-
| 价格可见性 | 公开,无需登录 |
|
|
12
|
-
| 官方文档最后更新 | 2026-08-12 |
|
|
13
|
-
|
|
14
|
-
## 1. 接入协议
|
|
15
|
-
|
|
16
|
-
与 Seedream 5.0 Pro 共用同一个接口:
|
|
17
|
-
|
|
18
|
-
- **接口**:`POST https://ark.cn-beijing.volces.com/api/v3/images/generations`
|
|
19
|
-
- **鉴权**:`Authorization: Bearer $ARK_API_KEY`
|
|
20
|
-
- **结果时效**:`response_format=url` 返回的链接 **24 小时内有效**
|
|
21
|
-
|
|
22
|
-
## 2. 能力清单(与 Pro 差异很大,勿混)
|
|
23
|
-
|
|
24
|
-
| 能力 | 说明 | 触发方式 |
|
|
25
|
-
|---|---|---|
|
|
26
|
-
| 文生图 | 单图 | 不传 `image`,`sequential_image_generation: disabled` |
|
|
27
|
-
| 单图生图 | 1 张参考图 | `image` 传 1 张 |
|
|
28
|
-
| 多图生图 | **2–14 张**参考图 → 单图 | `image` 传数组 |
|
|
29
|
-
| 文生组图 | 最多 15 张 | `sequential_image_generation: "auto"` |
|
|
30
|
-
| 单图生组图 | 最多 14 张 | 1 张 `image` + `auto` |
|
|
31
|
-
| 多图生组图 | 输入参考图数 + 生成图数 ≤ 15 | 多张 `image` + `auto` |
|
|
32
|
-
| 流式输出 | 每张图生成完即时返回 | `stream: true` |
|
|
33
|
-
| 联网搜索 | 模型自主判断是否搜索互联网内容 | `tools: [{ "type": "web_search" }]` |
|
|
34
|
-
|
|
35
|
-
**Lite 不支持**:图层拆分(`layer_decomposition`)、透明背景(`background`)——这两项是 Pro 独有。
|
|
36
|
-
|
|
37
|
-
## 3. 请求参数(Body)
|
|
38
|
-
|
|
39
|
-
| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
|
|
40
|
-
|---|---|---|---|---|
|
|
41
|
-
| `model` | string | 必选 | — | `doubao-seedream-5-0-260128` |
|
|
42
|
-
| `prompt` | string | 必选 | — | 支持中英文。建议中文 ≤ 300 字、英文 ≤ 600 词 |
|
|
43
|
-
| `image` | string / string[] | 可选 | — | 参考图,URL 或 `data:image/<小写格式>;base64,<编码>`。Lite **最多 14 张** |
|
|
44
|
-
| `size` | string | 可选 | 方式 2 下为 `2048x2048` | 见下 |
|
|
45
|
-
| `optimize_prompt_options.mode` | string | 可选 | `standard` | `standard`;**Lite 当前不支持 `fast`** |
|
|
46
|
-
| `output_format` | string | 可选 | `jpeg` | `png` / `jpeg` |
|
|
47
|
-
| `response_format` | string | 可选 | `url` | `url`(24 小时有效)/ `b64_json` |
|
|
48
|
-
| `sequential_image_generation` | string | 可选 | `disabled` | `disabled` / `auto`(组图) |
|
|
49
|
-
| `sequential_image_generation_options.max_images` | integer | 可选 | `15` | 取值 `[1, 15]`。**输入参考图数 + 最终生成数 ≤ 15** |
|
|
50
|
-
| `stream` | boolean | 可选 | `false` | 流式输出 |
|
|
51
|
-
| `tools[].type` | string | 可选 | — | `web_search`;实际搜索次数见 `usage.tool_usage.web_search` |
|
|
52
|
-
| `watermark` | boolean | 可选 | **`true`** | 官方默认加「AI 生成」水印,需要关闭必须显式传 `false` |
|
|
53
|
-
|
|
54
|
-
### size 取值(两种方式不可混用)
|
|
55
|
-
|
|
56
|
-
- 方式 1:分辨率档位 `2K` / `3K` / `4K`,宽高比由 prompt 自然语言描述后模型判断。**Lite 没有 1K / 1.5K 档。**
|
|
57
|
-
- 方式 2:精确像素 `宽x高`,默认 `2048x2048`。总像素范围 `[3686400 (2560×1440), 16777216 (4096×4096)]`,宽高比 `[1/16, 16]`,两个条件需同时满足。有效示例 `3750x1250`;无效示例 `1500x1500`(总像素不足)。
|
|
58
|
-
|
|
59
|
-
档位 → 宽高像素映射(官方参考值):
|
|
60
|
-
|
|
61
|
-
| 分辨率 | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 | 21:9 |
|
|
62
|
-
|---|---|---|---|---|---|---|---|---|
|
|
63
|
-
| 2K | 2048×2048 | 2304×1728 | 1728×2304 | 2848×1600 | 1600×2848 | 2496×1664 | 1664×2496 | 3136×1344 |
|
|
64
|
-
| 3K | 3072×3072 | 3456×2592 | 2592×3456 | 4096×2304 | 2304×4096 | 3744×2496 | 2496×3744 | 4704×2016 |
|
|
65
|
-
| 4K | 4096×4096 | 4704×3520 | 3520×4704 | 5504×3040 | 3040×5504 | 4992×3328 | 3328×4992 | 6240×2656 |
|
|
66
|
-
|
|
67
|
-
### 输入图片限制
|
|
68
|
-
|
|
69
|
-
格式 jpeg/png/webp/bmp/tiff/gif/heic/heif;宽高比 `[1/16, 16]`;单边 > 14 px;≤ 30 MB;总像素 `[196, 36000000]`。
|
|
70
|
-
|
|
71
|
-
## 4. 响应结构
|
|
72
|
-
|
|
73
|
-
顶层 `created` / `model` / `data[]` / `error` / `tools[]` / `usage`。`data[]` 含 `url` 或 `b64_json`、`size`、`output_format`。
|
|
74
|
-
|
|
75
|
-
**组图场景**:某张图失败时该元素额外返回 `data[].error`,其他图不受影响。官方说明:若失败原因是审核不通过,会继续生成后续图片;若是内部服务异常(500),不再继续。
|
|
76
|
-
|
|
77
|
-
流式响应的事件结构见「图片生成流式响应事件」文档。
|
|
78
|
-
|
|
79
|
-
## 5. 价格(官方,人民币)
|
|
80
|
-
|
|
81
|
-
来源:火山方舟「模型价格」(更新于 2026-08-20)。
|
|
82
|
-
|
|
83
|
-
| 模型 | 输入图 | 输出 |
|
|
84
|
-
|---|---|---|
|
|
85
|
-
| `doubao-seedream-5-0-lite` | 免费 | **0.22 元/张** |
|
|
86
|
-
|
|
87
|
-
组图场景按**实际生成的图片数量**计费。
|
|
88
|
-
|
|
89
|
-
## 6. 适配要点
|
|
90
|
-
|
|
91
|
-
- 本项目默认**绝对不显示**:`seed`、负面提示词。官方接口无这两个字段。
|
|
92
|
-
- `watermark` 官方默认 `true`,必须显式传 `false`。
|
|
93
|
-
- `output_format` 默认不显示、不请求。
|
|
94
|
-
- Lite 的分辨率档位是 **2K/3K/4K**,与 Pro 的 1K/1.5K/2K 完全不同,比例与档位映射也不同,不能共用一套映射表。
|
|
95
|
-
- 组图能力会改变返回数量与计费,若产品要开放,需要在 UI 上明确「输入参考图数 + 生成数 ≤ 15」的约束。
|
|
96
|
-
- 价格计算中的参考图数量必须同时识别生成提交、画布和对话/工具面板的三套媒体字段,避免空的本地路径数组遮蔽实时图片数组,进而把可生成张数和总价算高。
|
|
97
|
-
|
|
98
|
-
## 7. 原始链接索引
|
|
99
|
-
|
|
100
|
-
| 信息 | 链接 | 是否需登录 |
|
|
101
|
-
|---|---|---|
|
|
102
|
-
| 图片生成 API(Pro/Lite/4.5/4.0 合并文档) | https://console.volcengine.com/ark/region:cn-beijing/docs/82379/1541523?lang=zh | 否 |
|
|
103
|
-
| 公开镜像 | https://www.volcengine.com/docs/82379/1541523 | 否 |
|
|
104
|
-
| 图片生成流式响应事件 | https://www.volcengine.com/docs/82379/1824137 | 否 |
|
|
105
|
-
| 模型价格 | https://www.volcengine.com/docs/82379/1544106 | 否 |
|
|
106
|
-
| 模型列表(Model ID / 限流 / 能力) | https://www.volcengine.com/docs/82379/1330310 | 否 |
|
|
107
|
-
| Seedream 图像创作教程(组图、流式示例) | https://www.volcengine.com/docs/82379/1824121 | 否 |
|
|
108
|
-
| API Key 管理 | https://console.volcengine.com/ark/region:cn-beijing/apiKey | **是** |
|
|
1
|
+
# Seedream 5.0 Lite · 火山引擎(火山方舟,官方)
|
|
2
|
+
|
|
3
|
+
| 项目 | 内容 |
|
|
4
|
+
|---|---|
|
|
5
|
+
| 最后更新 | 2026-08-30 |
|
|
6
|
+
| 模态 | 图片 |
|
|
7
|
+
| 供应商 | 火山引擎 · 火山方舟(Ark),模型原厂官方接口 |
|
|
8
|
+
| 平台模型 ID | `doubao-seedream-5-0-260128`(同时支持写作 `doubao-seedream-5-0-lite-260128`) |
|
|
9
|
+
| 接口形态 | **同步**,可选流式(`stream: true`) |
|
|
10
|
+
| 文档可见性 | 公开,无需登录;调用需 API Key |
|
|
11
|
+
| 价格可见性 | 公开,无需登录 |
|
|
12
|
+
| 官方文档最后更新 | 2026-08-12 |
|
|
13
|
+
|
|
14
|
+
## 1. 接入协议
|
|
15
|
+
|
|
16
|
+
与 Seedream 5.0 Pro 共用同一个接口:
|
|
17
|
+
|
|
18
|
+
- **接口**:`POST https://ark.cn-beijing.volces.com/api/v3/images/generations`
|
|
19
|
+
- **鉴权**:`Authorization: Bearer $ARK_API_KEY`
|
|
20
|
+
- **结果时效**:`response_format=url` 返回的链接 **24 小时内有效**
|
|
21
|
+
|
|
22
|
+
## 2. 能力清单(与 Pro 差异很大,勿混)
|
|
23
|
+
|
|
24
|
+
| 能力 | 说明 | 触发方式 |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| 文生图 | 单图 | 不传 `image`,`sequential_image_generation: disabled` |
|
|
27
|
+
| 单图生图 | 1 张参考图 | `image` 传 1 张 |
|
|
28
|
+
| 多图生图 | **2–14 张**参考图 → 单图 | `image` 传数组 |
|
|
29
|
+
| 文生组图 | 最多 15 张 | `sequential_image_generation: "auto"` |
|
|
30
|
+
| 单图生组图 | 最多 14 张 | 1 张 `image` + `auto` |
|
|
31
|
+
| 多图生组图 | 输入参考图数 + 生成图数 ≤ 15 | 多张 `image` + `auto` |
|
|
32
|
+
| 流式输出 | 每张图生成完即时返回 | `stream: true` |
|
|
33
|
+
| 联网搜索 | 模型自主判断是否搜索互联网内容 | `tools: [{ "type": "web_search" }]` |
|
|
34
|
+
|
|
35
|
+
**Lite 不支持**:图层拆分(`layer_decomposition`)、透明背景(`background`)——这两项是 Pro 独有。
|
|
36
|
+
|
|
37
|
+
## 3. 请求参数(Body)
|
|
38
|
+
|
|
39
|
+
| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
|
|
40
|
+
|---|---|---|---|---|
|
|
41
|
+
| `model` | string | 必选 | — | `doubao-seedream-5-0-260128` |
|
|
42
|
+
| `prompt` | string | 必选 | — | 支持中英文。建议中文 ≤ 300 字、英文 ≤ 600 词 |
|
|
43
|
+
| `image` | string / string[] | 可选 | — | 参考图,URL 或 `data:image/<小写格式>;base64,<编码>`。Lite **最多 14 张** |
|
|
44
|
+
| `size` | string | 可选 | 方式 2 下为 `2048x2048` | 见下 |
|
|
45
|
+
| `optimize_prompt_options.mode` | string | 可选 | `standard` | `standard`;**Lite 当前不支持 `fast`** |
|
|
46
|
+
| `output_format` | string | 可选 | `jpeg` | `png` / `jpeg` |
|
|
47
|
+
| `response_format` | string | 可选 | `url` | `url`(24 小时有效)/ `b64_json` |
|
|
48
|
+
| `sequential_image_generation` | string | 可选 | `disabled` | `disabled` / `auto`(组图) |
|
|
49
|
+
| `sequential_image_generation_options.max_images` | integer | 可选 | `15` | 取值 `[1, 15]`。**输入参考图数 + 最终生成数 ≤ 15** |
|
|
50
|
+
| `stream` | boolean | 可选 | `false` | 流式输出 |
|
|
51
|
+
| `tools[].type` | string | 可选 | — | `web_search`;实际搜索次数见 `usage.tool_usage.web_search` |
|
|
52
|
+
| `watermark` | boolean | 可选 | **`true`** | 官方默认加「AI 生成」水印,需要关闭必须显式传 `false` |
|
|
53
|
+
|
|
54
|
+
### size 取值(两种方式不可混用)
|
|
55
|
+
|
|
56
|
+
- 方式 1:分辨率档位 `2K` / `3K` / `4K`,宽高比由 prompt 自然语言描述后模型判断。**Lite 没有 1K / 1.5K 档。**
|
|
57
|
+
- 方式 2:精确像素 `宽x高`,默认 `2048x2048`。总像素范围 `[3686400 (2560×1440), 16777216 (4096×4096)]`,宽高比 `[1/16, 16]`,两个条件需同时满足。有效示例 `3750x1250`;无效示例 `1500x1500`(总像素不足)。
|
|
58
|
+
|
|
59
|
+
档位 → 宽高像素映射(官方参考值):
|
|
60
|
+
|
|
61
|
+
| 分辨率 | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 | 21:9 |
|
|
62
|
+
|---|---|---|---|---|---|---|---|---|
|
|
63
|
+
| 2K | 2048×2048 | 2304×1728 | 1728×2304 | 2848×1600 | 1600×2848 | 2496×1664 | 1664×2496 | 3136×1344 |
|
|
64
|
+
| 3K | 3072×3072 | 3456×2592 | 2592×3456 | 4096×2304 | 2304×4096 | 3744×2496 | 2496×3744 | 4704×2016 |
|
|
65
|
+
| 4K | 4096×4096 | 4704×3520 | 3520×4704 | 5504×3040 | 3040×5504 | 4992×3328 | 3328×4992 | 6240×2656 |
|
|
66
|
+
|
|
67
|
+
### 输入图片限制
|
|
68
|
+
|
|
69
|
+
格式 jpeg/png/webp/bmp/tiff/gif/heic/heif;宽高比 `[1/16, 16]`;单边 > 14 px;≤ 30 MB;总像素 `[196, 36000000]`。
|
|
70
|
+
|
|
71
|
+
## 4. 响应结构
|
|
72
|
+
|
|
73
|
+
顶层 `created` / `model` / `data[]` / `error` / `tools[]` / `usage`。`data[]` 含 `url` 或 `b64_json`、`size`、`output_format`。
|
|
74
|
+
|
|
75
|
+
**组图场景**:某张图失败时该元素额外返回 `data[].error`,其他图不受影响。官方说明:若失败原因是审核不通过,会继续生成后续图片;若是内部服务异常(500),不再继续。
|
|
76
|
+
|
|
77
|
+
流式响应的事件结构见「图片生成流式响应事件」文档。
|
|
78
|
+
|
|
79
|
+
## 5. 价格(官方,人民币)
|
|
80
|
+
|
|
81
|
+
来源:火山方舟「模型价格」(更新于 2026-08-20)。
|
|
82
|
+
|
|
83
|
+
| 模型 | 输入图 | 输出 |
|
|
84
|
+
|---|---|---|
|
|
85
|
+
| `doubao-seedream-5-0-lite` | 免费 | **0.22 元/张** |
|
|
86
|
+
|
|
87
|
+
组图场景按**实际生成的图片数量**计费。
|
|
88
|
+
|
|
89
|
+
## 6. 适配要点
|
|
90
|
+
|
|
91
|
+
- 本项目默认**绝对不显示**:`seed`、负面提示词。官方接口无这两个字段。
|
|
92
|
+
- `watermark` 官方默认 `true`,必须显式传 `false`。
|
|
93
|
+
- `output_format` 默认不显示、不请求。
|
|
94
|
+
- Lite 的分辨率档位是 **2K/3K/4K**,与 Pro 的 1K/1.5K/2K 完全不同,比例与档位映射也不同,不能共用一套映射表。
|
|
95
|
+
- 组图能力会改变返回数量与计费,若产品要开放,需要在 UI 上明确「输入参考图数 + 生成数 ≤ 15」的约束。
|
|
96
|
+
- 价格计算中的参考图数量必须同时识别生成提交、画布和对话/工具面板的三套媒体字段,避免空的本地路径数组遮蔽实时图片数组,进而把可生成张数和总价算高。
|
|
97
|
+
|
|
98
|
+
## 7. 原始链接索引
|
|
99
|
+
|
|
100
|
+
| 信息 | 链接 | 是否需登录 |
|
|
101
|
+
|---|---|---|
|
|
102
|
+
| 图片生成 API(Pro/Lite/4.5/4.0 合并文档) | https://console.volcengine.com/ark/region:cn-beijing/docs/82379/1541523?lang=zh | 否 |
|
|
103
|
+
| 公开镜像 | https://www.volcengine.com/docs/82379/1541523 | 否 |
|
|
104
|
+
| 图片生成流式响应事件 | https://www.volcengine.com/docs/82379/1824137 | 否 |
|
|
105
|
+
| 模型价格 | https://www.volcengine.com/docs/82379/1544106 | 否 |
|
|
106
|
+
| 模型列表(Model ID / 限流 / 能力) | https://www.volcengine.com/docs/82379/1330310 | 否 |
|
|
107
|
+
| Seedream 图像创作教程(组图、流式示例) | https://www.volcengine.com/docs/82379/1824121 | 否 |
|
|
108
|
+
| API Key 管理 | https://console.volcengine.com/ark/region:cn-beijing/apiKey | **是** |
|