输入文件

三种给法

文件以三种形态进请求：公网URL写在JSON里；URL作为multipart表单的一个字段；或者文件本体作为表单分段。NextLabs的表单里永远填URL，由它换成对应接口要的形态。

• 「文件本体」那一行：NextLabs先把URL下载下来，再作为分段上传。其余接口都收到URL，由平台自己去取——所以URL必须公网可读，不能带登录。
• base64：填一个data:地址时，Gemini、Gemini、Anthropic Messages会被改写成接口自己的内嵌格式（Gemini的inlineData、Anthropic的base64源）；其余接口原样发出。实测都是用URL做的，data:地址平台是否接受没有实测。

大小与格式

平台没有公开输入文件的大小上限和格式清单。能确认的只有两件事：NextLabs的上传收什么，以及实测时什么通过了。

• 每个账号每天最多300次上传；超过大小返回413，类型不在表里返回400。
• 平台没公开，实测通过：作为文件本体上传的webp · 62.6 KB（Nano Banana Pro，DRAW 2026-10-22）。
• 通过URL给的输入，实测用的是NextLabs素材桶里的webp、mp4文件（960像素宽的静帧、几秒的短片）；它们的字节数没有记录，平台对URL文件的上限没公开。

用NextLabs的上传

在任何参数表的文件项里选一个文件（要登录），它就变成平台能读的URL：浏览器先向POST /v1/uploads要一个预签名地址，把字节直接传进对象存储，再调/complete核对大小和类型。拿到的URL不带签名、公网可读，直接填进请求。

• 上传的文件只临时保存：24小时后由维护任务删除。范式和精选作品用到的不删。要留的自己下载。
• 作品的产物也一样：公开或不列出的作品，文件是普通URL；其他作品的文件走带签名的链接，签名至少一小时有效。
• 你自己的URL也行：只要公网可读、不需要登录，任何地址都能填进文件项。

常见错误

平台那边，和文件有关的错误码：

NextLabs自己的上传接口，返回这些：

平台见过的每一种错误、是谁的问题、该怎么办，都在错误码页。