Upload a file

Upload a file for use in inference requests.

POST /files

Upload a file for batch or user-data use.

Request body

Content Type: multipart/form-data

CreateFileRequest

Response

HTTP 200 — OK

Content Type: application/json

FileObject

python
import os
from openai import OpenAI
client = OpenAI(
    base_url="https://api.meta.ai/v1",
    api_key=os.environ["MODEL_API_KEY"],
)
with open("/path/to/image.png", "rb") as f:
    file = client.files.create(
        purpose="user_data",
        file=f,
    )
print(file.model_dump_json(indent=2))

python
import json
import os
import requests
with open("/path/to/image.png", "rb") as f:
    response = requests.post(
        "https://api.meta.ai/v1/files",
        headers={"Authorization": f"Bearer {os.environ['MODEL_API_KEY']}"},
        data={
            "purpose": "user_data",
        },
        files={"file": f},
    )
response.raise_for_status()
print(json.dumps(response.json(), indent=2))

shell
curl -X POST "https://api.meta.ai/v1/files" \
  -H "Authorization: Bearer $MODEL_API_KEY" \
  -F "purpose=user_data" \
  -F "file=@/path/to/image.png"

For supported file types, upload examples, and how to reference files in requests, see the Files feature page.

Upload a file

POST /files

Request body

Content Type: multipart/form-data

Response

Content Type: application/json

Please confirm your identity

Upload a file

POST /files

Request body

Content Type: multipart/form-data

Response

Content Type: application/json

Please confirm your identity