> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neural4d.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 上传文件
> 上传一个本地图片、视频或音频文件，并返回可复用的文件 ID。
## 授权
使用 Bearer 方式发送的 Neural4D API 密钥。
## 请求体 multipart/form-data
需要上传的文件。图片支持 JPG、JPEG、PNG、GIF、WEBP、BMP、HEIC 和 HEIF；视频支持 MP4、MOV、WEBM、M4V、OGG 和 OGV；音频支持 MP3 和 WAV。
```bash cURL theme={null}
curl --request POST \
--url https://api.neural4d.com/openapi/v1/files \
--header 'Authorization: Bearer ' \
--form 'file=@/path/to/file.png'
```
```python Python theme={null}
import requests
response = requests.request(
"POST",
"https://api.neural4d.com/openapi/v1/files",
headers={
"Authorization": "Bearer ",
},
files={"file": open('/path/to/file', 'rb')},
)
print(response.json())
```
```javascript JavaScript theme={null}
const response = await fetch("https://api.neural4d.com/openapi/v1/files", {
method: "POST",
headers: {
"Authorization": "Bearer "
},
body: (() => { const form = new FormData(); form.append("file", fileInput.files[0]); return form; })(),
});
const data = await response.json();
console.log(data);
```
```typescript TypeScript theme={null}
const response: Response = await fetch("https://api.neural4d.com/openapi/v1/files", {
method: "POST",
headers: {
"Authorization": "Bearer "
},
body: (() => { const form = new FormData(); form.append("file", fileInput.files[0]); return form; })(),
});
const data = await response.json();
console.log(data);
```
```java Java theme={null}
import java.net.URI;
import java.net.http.*;
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.neural4d.com/openapi/v1/files"))
.header("Authorization", "Bearer ")
.method("POST", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```
```go Go theme={null}
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
payload := nil
req, _ := http.NewRequest("POST", "https://api.neural4d.com/openapi/v1/files", payload)
req.Header.Set("Authorization", "Bearer ")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
bodyBytes, _ := io.ReadAll(resp.Body)
fmt.Println(string(bodyBytes))
```
```ruby Ruby theme={null}
require "net/http"
require "json"
uri = URI("https://api.neural4d.com/openapi/v1/files")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer "
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
puts response.body
```
```php PHP theme={null}
"POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer "],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```
```csharp C# theme={null}
using System.Net.Http;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.neural4d.com/openapi/v1/files");
request.Headers.TryAddWithoutValidation("Authorization", "Bearer ");
using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```
## 响应
文件已上传
生成请求使用的文件 ID。
示例：`"550e8400-e29b-41d4-a716-446655440000"`。
上传文件的原始名称。
示例：`"first-frame.png"`。
上传文件大小，单位为字节。
取值范围：`0 <= x <= infinity`。
示例：`245760`。
检测到的上传文件媒体类型。
示例：`"image/png"`。
文件创建时间的 Unix 时间戳，单位为秒。
请求无效
结构化错误详情。
稳定且可供程序读取的错误码。
示例：`"invalid_prompt"`。
便于阅读的错误说明。
示例：`"prompt is required and must be a non-empty string"`。
包含此错误更多信息的可选文档 URL。
示例：`"https://api.neural4d.com/docs/errors#invalid_prompt"`。
认证失败
结构化错误详情。
稳定且可供程序读取的错误码。
示例：`"invalid_prompt"`。
便于阅读的错误说明。
示例：`"prompt is required and must be a non-empty string"`。
包含此错误更多信息的可选文档 URL。
示例：`"https://api.neural4d.com/docs/errors#invalid_prompt"`。
当前已认证用户无权访问该资源或点数不足
结构化错误详情。
稳定且可供程序读取的错误码。
示例：`"invalid_prompt"`。
便于阅读的错误说明。
示例：`"prompt is required and must be a non-empty string"`。
包含此错误更多信息的可选文档 URL。
示例：`"https://api.neural4d.com/docs/errors#invalid_prompt"`。
已超过请求或配额限制
结构化错误详情。
稳定且可供程序读取的错误码。
示例：`"invalid_prompt"`。
便于阅读的错误说明。
示例：`"prompt is required and must be a non-empty string"`。
包含此错误更多信息的可选文档 URL。
示例：`"https://api.neural4d.com/docs/errors#invalid_prompt"`。
内部或上游服务错误
结构化错误详情。
稳定且可供程序读取的错误码。
示例：`"invalid_prompt"`。
便于阅读的错误说明。
示例：`"prompt is required and must be a non-empty string"`。
包含此错误更多信息的可选文档 URL。
示例：`"https://api.neural4d.com/docs/errors#invalid_prompt"`。
```json 201 Example theme={null}
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"filename": "first-frame.png",
"bytes": 245760,
"mime_type": "image/png",
"created_at": 1784044800
}
```
```json 400 invalid_prompt theme={null}
{
"error": {
"code": "invalid_prompt",
"message": "prompt is required and must be a non-empty string"
}
}
```
```json 400 unsupported_model theme={null}
{
"error": {
"code": "unsupported_model",
"message": "Unsupported modelKey: missing-model"
}
}
```
```json 400 model_unavailable theme={null}
{
"error": {
"code": "model_unavailable",
"message": "Model is unavailable: veo-3.1"
}
}
```
```json 401 Example theme={null}
{
"error": {
"code": "invalid_api_key",
"message": "The API key is invalid or expired"
}
}
```
```json 403 Example theme={null}
{
"error": {
"code": "insufficient_credits",
"message": "Insufficient credits for video generation"
}
}
```
```json 429 Example theme={null}
{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after the indicated interval."
}
}
```
```json 500 Example theme={null}
{
"error": {
"code": "internal_error",
"message": "An internal error occurred"
}
}
```