@henjicc/ai-sdk 0.2.8 → 0.3.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.
Files changed (236) hide show
  1. package/CHANGELOG.md +153 -143
  2. package/README.md +486 -461
  3. package/dist/capabilities/embedding/bailian.d.ts +23 -0
  4. package/dist/capabilities/embedding/bailian.js +10 -0
  5. package/dist/capabilities/embedding/bigmodel.d.ts +9 -0
  6. package/dist/capabilities/embedding/bigmodel.js +5 -0
  7. package/dist/capabilities/embedding/index.d.ts +1 -0
  8. package/dist/capabilities/embedding/index.js +1 -0
  9. package/dist/capabilities/embedding/ppio.d.ts +7 -0
  10. package/dist/capabilities/embedding/ppio.js +5 -0
  11. package/dist/capabilities/embedding/siliconflow.d.ts +21 -0
  12. package/dist/capabilities/embedding/siliconflow.js +10 -0
  13. package/dist/capabilities/embedding/volcengine.d.ts +10 -0
  14. package/dist/capabilities/embedding/volcengine.js +6 -0
  15. package/dist/capabilities/rerank/bailian.d.ts +21 -0
  16. package/dist/capabilities/rerank/bailian.js +14 -0
  17. package/dist/capabilities/rerank/bigmodel.d.ts +9 -0
  18. package/dist/capabilities/rerank/bigmodel.js +5 -0
  19. package/dist/capabilities/rerank/index.d.ts +1 -0
  20. package/dist/capabilities/rerank/index.js +1 -0
  21. package/dist/capabilities/rerank/ppio.d.ts +7 -0
  22. package/dist/capabilities/rerank/ppio.js +5 -0
  23. package/dist/capabilities/rerank/siliconflow.d.ts +21 -0
  24. package/dist/capabilities/rerank/siliconflow.js +10 -0
  25. package/dist/capabilities/retrieval/http.d.ts +3 -0
  26. package/dist/capabilities/retrieval/http.js +48 -0
  27. package/dist/capabilities/retrieval/module.d.ts +11 -0
  28. package/dist/capabilities/retrieval/module.js +110 -0
  29. package/dist/capabilities/retrieval/types.d.ts +54 -0
  30. package/dist/capabilities/retrieval/types.js +1 -0
  31. package/dist/capabilities/retrieval/validation.d.ts +10 -0
  32. package/dist/capabilities/retrieval/validation.js +65 -0
  33. package/dist/capabilities/types.d.ts +1 -1
  34. package/dist/catalog/apimart/gpt-image-2.5.model.d.ts +2 -0
  35. package/dist/catalog/apimart/gpt-image-2.5.model.js +51 -0
  36. package/dist/catalog/fal/gpt-image-2.5.model.d.ts +2 -0
  37. package/dist/catalog/fal/gpt-image-2.5.model.js +53 -0
  38. package/dist/catalog/fal/ic-light-v2.model.js +9 -13
  39. package/dist/catalog/grsai/gpt-image-2.5.model.d.ts +2 -0
  40. package/dist/catalog/grsai/gpt-image-2.5.model.js +54 -0
  41. package/dist/catalog/grsai/gptImage25Sizes.d.ts +1 -0
  42. package/dist/catalog/grsai/gptImage25Sizes.js +76 -0
  43. package/dist/catalog/index.js +112 -104
  44. package/dist/catalog/kie/gpt-image-2.5.model.d.ts +2 -0
  45. package/dist/catalog/kie/gpt-image-2.5.model.js +38 -0
  46. package/dist/catalog/shared/gptImage25.d.ts +16 -0
  47. package/dist/catalog/shared/gptImage25.js +48 -0
  48. package/dist/catalog/shared/gptImage25Pricing.d.ts +12 -0
  49. package/dist/catalog/shared/gptImage25Pricing.js +508 -0
  50. package/dist/llm/defaults.d.ts +1 -1
  51. package/dist/llm/defaults.js +1 -1
  52. package/dist/llm/modelCatalogEntries.js +16 -0
  53. package/dist/llm/providerPresets.js +2 -2
  54. package/dist/packs/models/apimart/gpt-image-2.5.d.ts +6 -0
  55. package/dist/packs/models/apimart/gpt-image-2.5.js +7 -0
  56. package/dist/packs/models/fal/gpt-image-2.5.d.ts +6 -0
  57. package/dist/packs/models/fal/gpt-image-2.5.js +7 -0
  58. package/dist/packs/models/grsai/gpt-image-2.5.d.ts +6 -0
  59. package/dist/packs/models/grsai/gpt-image-2.5.js +7 -0
  60. package/dist/packs/models/kie/gpt-image-2.5.d.ts +6 -0
  61. package/dist/packs/models/kie/gpt-image-2.5.js +7 -0
  62. package/dist/packs/provider-packs/apimart.d.ts +1 -1
  63. package/dist/packs/provider-packs/apimart.js +21 -20
  64. package/dist/packs/provider-packs/fal.d.ts +1 -1
  65. package/dist/packs/provider-packs/fal.js +37 -36
  66. package/dist/packs/provider-packs/grsai.d.ts +1 -1
  67. package/dist/packs/provider-packs/grsai.js +6 -5
  68. package/dist/packs/provider-packs/kie.d.ts +1 -1
  69. package/dist/packs/provider-packs/kie.js +28 -27
  70. package/dist/packs/tool-models/fal/{qwen-image-edit-2509-multiple-angles.d.ts → qwen-image-edit-2511-multiple-angles.d.ts} +1 -1
  71. package/dist/packs/tool-models/fal/{qwen-image-edit-2509-multiple-angles.js → qwen-image-edit-2511-multiple-angles.js} +1 -1
  72. package/dist/packs/tool-packs/fal-multi-angle-tools.js +1 -1
  73. package/dist/tool-packs/fal-multi-angle/models/qwen-image-edit-2511-multiple-angles.model.d.ts +2 -0
  74. 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
  75. package/docs/README.md +26 -26
  76. package/docs/consumers.md +54 -48
  77. package/docs/llm-adaptation/README.md +139 -139
  78. package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/DeepSeek.md +103 -91
  79. package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/Kimi.md +75 -75
  80. package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/MiniMax.md +84 -84
  81. package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//345/260/217/347/261/263MiMo.md +85 -85
  82. package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//346/231/272/350/260/261GLM.md +232 -232
  83. 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
  84. package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//347/231/276/347/202/274Qwen.md +84 -84
  85. 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
  86. package/docs/model-adaptation/Bria-Eraser/Bria-Eraser_Fal.md +32 -32
  87. 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
  88. package/docs/model-adaptation/ControlLight/ControlLight_Fal.md +85 -85
  89. 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
  90. package/docs/model-adaptation/Finegrain-Eraser/Finegrain-Eraser_Fal.md +31 -31
  91. package/docs/model-adaptation/Flux-Pro-Erase/Flux-Pro-Erase_Fal.md +34 -34
  92. package/docs/model-adaptation/Fun-ASR/Fun-ASR_/347/231/276/347/202/274.md +43 -43
  93. 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
  94. package/docs/model-adaptation/Fun-ASR-Realtime/Fun-ASR-Realtime_/347/231/276/347/202/274.md +37 -37
  95. 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
  96. package/docs/model-adaptation/GLM-5.3-Flash/GLM-5.3-Flash_/346/231/272/350/260/261.md +207 -207
  97. package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_APIMart.md +173 -173
  98. package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_Fal.md +94 -94
  99. package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_Grsai.md +137 -137
  100. package/docs/model-adaptation/GPT-Image-2/GPT-Image-2_KIE.md +93 -93
  101. package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_APIMart.md +66 -0
  102. package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_Fal.md +55 -0
  103. package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_Grsai.md +53 -0
  104. package/docs/model-adaptation/GPT-Image-2.5/GPT-Image-2.5_KIE.md +55 -0
  105. package/docs/model-adaptation/GPT-OSS-20B/GPT-OSS-20B_Groq.md +62 -62
  106. package/docs/model-adaptation/Gemini-Omni-Flash/Gemini-Omni-Flash_APIMart.md +124 -124
  107. package/docs/model-adaptation/Gemini-Omni-Flash/Gemini-Omni-Flash_Fal.md +84 -84
  108. package/docs/model-adaptation/Gemini-Omni-Flash/Gemini-Omni-Flash_KIE.md +129 -129
  109. package/docs/model-adaptation/Grok-Imagine/Grok-Imagine_KIE.md +36 -36
  110. package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_APIMart.md +250 -250
  111. package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_Fal.md +84 -84
  112. package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_KIE.md +105 -105
  113. package/docs/model-adaptation/Hailuo-02/Hailuo-02_Fal.md +93 -93
  114. package/docs/model-adaptation/Hailuo-02/Hailuo-02_KIE.md +56 -56
  115. package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_Fal.md +88 -88
  116. package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_KIE.md +51 -51
  117. package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_/346/264/276/346/254/247/344/272/221.md +70 -70
  118. package/docs/model-adaptation/IC-Light-v2/IC-Light-v2_Fal.md +97 -94
  119. 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
  120. 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
  121. 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
  122. 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
  123. 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
  124. package/docs/model-adaptation/Kling-3.0/Kling-3.0_APIMart.md +112 -112
  125. package/docs/model-adaptation/Kling-3.0/Kling-3.0_Fal.md +89 -89
  126. package/docs/model-adaptation/Kling-3.0/Kling-3.0_KIE.md +106 -106
  127. package/docs/model-adaptation/Kling-3.0/Kling-3.0_/346/264/276/346/254/247/344/272/221.md +119 -119
  128. package/docs/model-adaptation/Kling-3.0-Omni/Kling-3.0-Omni_APIMart.md +125 -125
  129. package/docs/model-adaptation/Kling-3.0-Omni/Kling-3.0-Omni_Fal.md +107 -107
  130. package/docs/model-adaptation/Kling-3.0-Omni/Kling-3.0-Omni_KIE.md +143 -143
  131. package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_APIMart.md +85 -85
  132. package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_Fal.md +83 -83
  133. package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_KIE.md +84 -84
  134. package/docs/model-adaptation/Midjourney/Midjourney_APIMart.md +396 -396
  135. package/docs/model-adaptation/MiniMax-H3/MiniMax-H3_APIMart.md +234 -234
  136. package/docs/model-adaptation/MiniMax-H3/MiniMax-H3_Fal.md +108 -108
  137. package/docs/model-adaptation/MiniMax-H3/MiniMax-H3_KIE.md +111 -111
  138. package/docs/model-adaptation/MiniMax-Speech/MiniMax-Speech_/346/264/276/346/254/247/344/272/221.md +170 -170
  139. package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_APIMart.md +89 -89
  140. package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_Fal.md +99 -99
  141. package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_Grsai.md +82 -82
  142. package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_KIE.md +70 -70
  143. package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_APIMart.md +79 -79
  144. package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md +65 -65
  145. package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_KIE.md +64 -64
  146. package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_APIMart.md +83 -83
  147. package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_Fal.md +89 -89
  148. package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_Grsai.md +82 -82
  149. package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_KIE.md +64 -64
  150. 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
  151. package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_APIMart.md +117 -117
  152. package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_Fal.md +84 -84
  153. package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_KIE.md +103 -103
  154. package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_/347/231/276/347/202/274.md +138 -138
  155. 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
  156. package/docs/model-adaptation/Qwen-MT-Flash/Qwen-MT-Flash_/347/231/276/347/202/274.md +47 -47
  157. package/docs/model-adaptation/Qwen-MT-Lite/Qwen-MT-Lite_/347/231/276/347/202/274.md +39 -39
  158. package/docs/model-adaptation/Qwen-MT-Plus/Qwen-MT-Plus_/347/231/276/347/202/274.md +39 -39
  159. package/docs/model-adaptation/Qwen3-ASR-Flash/Qwen3-ASR-Flash_/347/231/276/347/202/274.md +40 -40
  160. 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
  161. package/docs/model-adaptation/Qwen3-ASR-Flash-Filetrans/Qwen3-ASR-Flash-Filetrans_/347/231/276/347/202/274.md +41 -41
  162. package/docs/model-adaptation/Qwen3-ASR-Flash-Realtime/Qwen3-ASR-Flash-Realtime_/347/231/276/347/202/274.md +35 -35
  163. 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
  164. package/docs/model-adaptation/README.md +313 -295
  165. 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
  166. 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
  167. 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
  168. package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_APIMart.md +121 -121
  169. package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_Fal.md +97 -97
  170. package/docs/model-adaptation/Seedance-2.0/Seedance-2.0_KIE.md +86 -86
  171. package/docs/model-adaptation/Seedance-2.0-Fast/Seedance-2.0-Fast_APIMart.md +89 -89
  172. package/docs/model-adaptation/Seedance-2.0-Fast/Seedance-2.0-Fast_Fal.md +95 -95
  173. package/docs/model-adaptation/Seedance-2.0-Fast/Seedance-2.0-Fast_KIE.md +78 -78
  174. package/docs/model-adaptation/Seedance-2.0-Mini/Seedance-2.0-Mini_APIMart.md +89 -89
  175. package/docs/model-adaptation/Seedance-2.0-Mini/Seedance-2.0-Mini_Fal.md +96 -96
  176. package/docs/model-adaptation/Seedance-2.0-Mini/Seedance-2.0-Mini_KIE.md +78 -78
  177. package/docs/model-adaptation/Seedance-2.5/Seedance-2.5_APIMart.md +212 -212
  178. package/docs/model-adaptation/Seedance-2.5/Seedance-2.5_Fal.md +94 -94
  179. package/docs/model-adaptation/Seedance-2.5/Seedance-2.5_KIE.md +89 -89
  180. package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_APIMart.md +106 -106
  181. package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_Fal.md +91 -91
  182. package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_KIE.md +89 -89
  183. 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
  184. package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_APIMart.md +194 -194
  185. package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_Fal.md +100 -100
  186. package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_KIE.md +141 -141
  187. 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
  188. package/docs/model-adaptation/SenseVoiceSmall/SenseVoiceSmall_/347/241/205/345/237/272/346/265/201/345/212/250.md +69 -69
  189. package/docs/model-adaptation/TeleSpeechASR/TeleSpeechASR_/347/241/205/345/237/272/346/265/201/345/212/250.md +72 -72
  190. 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
  191. 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
  192. package/docs/model-adaptation/Wan-2.5-Preview/Wan-2.5-Preview_/346/264/276/346/254/247/344/272/221.md +82 -82
  193. package/docs/model-adaptation/Wan-2.6/Wan-2.6_/346/264/276/346/254/247/344/272/221.md +84 -84
  194. package/docs/model-adaptation/Wan-2.7/Wan-2.7_/346/264/276/346/254/247/344/272/221.md +122 -122
  195. package/docs/model-adaptation/Whisper-Large-v3/Whisper-Large-v3_Groq.md +76 -76
  196. package/docs/model-adaptation/Whisper-Large-v3-Turbo/Whisper-Large-v3-Turbo_Groq.md +75 -75
  197. package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_APIMart.md +88 -88
  198. package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_Fal.md +95 -95
  199. package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_KIE.md +71 -71
  200. package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_/347/231/276/347/202/274.md +122 -122
  201. package/docs/model-adaptation/Z-Image-Turbo/Z-Image-Turbo_/351/255/224/346/220/255.md +97 -97
  202. package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/APIMart.md +238 -238
  203. package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/Fal.md +172 -172
  204. package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/Groq.md +121 -121
  205. package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/Grsai.md +217 -217
  206. package/docs/model-adaptation//344/276/233/345/272/224/345/225/206/KIE.md +131 -131
  207. 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
  208. 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
  209. 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
  210. 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
  211. package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//347/231/276/347/202/274.md +237 -227
  212. 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 +110 -88
  213. package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//351/255/224/346/220/255.md +207 -207
  214. 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
  215. 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
  216. package/docs//346/216/245/345/205/245/346/214/207/345/215/227/Electron.md +77 -77
  217. package/docs//346/216/245/345/205/245/346/214/207/345/215/227/Tauri.md +81 -81
  218. package/docs//346/216/245/345/205/245/346/214/207/345/215/227/UXP.md +169 -169
  219. 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
  220. 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
  221. package/examples/form-renderer/README.md +17 -17
  222. package/examples/form-renderer/cli.ts +32 -32
  223. package/examples/form-renderer/index.ts +144 -144
  224. package/examples/form-renderer/package.json +16 -16
  225. package/examples/form-renderer/tsconfig.json +14 -14
  226. package/examples/llm-chat/README.md +32 -32
  227. package/examples/llm-chat/index.ts +100 -100
  228. package/examples/llm-chat/package.json +19 -19
  229. package/examples/llm-chat/tsconfig.json +14 -14
  230. package/examples/minimal-node/README.md +31 -31
  231. package/examples/minimal-node/index.ts +138 -138
  232. package/examples/minimal-node/package.json +17 -17
  233. package/examples/minimal-node/tsconfig.json +14 -14
  234. package/package.json +252 -197
  235. package/dist/tool-packs/fal-multi-angle/models/qwen-image-edit-2509-multiple-angles.model.d.ts +0 -2
  236. 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 | **是** |