Skip to main content
ShuYou exposes an OpenAI-compatible Files API at /v1/files. Upload once, reuse the returned file_id across inference requests.

​
Workflow

1

Upload

Upload File with multipart/form-data.
2

Reference in inference

Pass file_id in Chat Completions or Responses API messages. See Multimodal guide.
3

Manage

List Files and Delete File when no longer needed.

​
When to upload vs inline

ApproachBest for
Files API uploadLarge files, reuse across multiple requests, Responses API input_file
URL in message bodyPublicly accessible assets without storing on ShuYou
Base64 in message bodySmall files, one-off requests
Use openai.files.create() with base_url="https://api.shuyou.ai/v1".

​
API endpoints

EndpointDescription
Upload FilePOST /v1/files
List FilesGET /v1/files
Delete FileDELETE /v1/files/{file_id}