--- title: ファイルを作成する | RunAPI description: 1つのマルチパートuser_dataまたはバッチFileを永続ストレージにストリームします。 url: https://runapi.ai/ja/docs/api/protocol/files/create.md canonical: https://runapi.ai/ja/docs/api/protocol/files/create locale: ja --- > HTML 版: https://runapi.ai/ja/docs/api/protocol/files/create > エージェント向けサイトインデックス: https://runapi.ai/llms.txt # ファイルを作成する 1つのマルチパートuser_dataまたはバッチFileを永続ストレージにストリームします。 ## エンドポイント POST /v1/files ベースURL: https://runapi.ai API バージョン: v1 認証: Authorization: Bearer YOUR_API_KEY ## リクエスト 指定されたリクエストの場所にのみ値を送信してください。 ### multipart/form-data ```json { "file": { "description": "保存するファイルのバイトデータ。", "format": "binary", "required": true, "type": "string" }, "purpose": { "default": "user_data", "description": "ファイルの目的。", "enum": [ "user_data", "batch" ], "required": true, "type": "string" } } ``` ## 成功レスポンス HTTP 200 - POST /v1/files ```json { "bytes": 1048576, "created_at": 1785196800, "filename": "knowledge.pdf", "id": "file_abc123", "object": "file", "purpose": "user_data" } ``` ## エラーレスポンス (401) HTTP 401 ### レスポンススキーマ ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### レスポンス例 ```json { "error": { "code": "authentication_error", "message": "Missing API key", "param": null, "type": "authentication_error" } } ``` ## エラーレスポンス (400) HTTP 400 ### レスポンススキーマ ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### レスポンス例 ```json { "error": { "code": "invalid_request_error", "message": "Malformed request", "param": null, "type": "invalid_request_error" } } ``` ## エラーレスポンス (404) HTTP 404 ### レスポンススキーマ ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### レスポンス例 ```json { "error": { "code": "not_found", "message": "File not found", "param": null, "type": "invalid_request_error" } } ``` ## エラーレスポンス (409) HTTP 409 ### レスポンススキーマ ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### レスポンス例 ```json { "error": { "code": "upload_state_conflict", "message": "Upload state conflict", "param": null, "type": "invalid_request_error" } } ``` ## エラーレスポンス (413) HTTP 413 ### レスポンススキーマ ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### レスポンス例 ```json { "error": { "code": "file_too_large", "message": "File size exceeds the maximum allowed size", "param": "file", "type": "invalid_request_error" } } ``` ## エラーレスポンス (422) HTTP 422 ### レスポンススキーマ ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### レスポンス例 ```json { "error": { "code": "invalid_upload", "message": "Upload request rejected", "param": null, "type": "invalid_request_error" } } ``` ## エラーレスポンス (502) HTTP 502 ### レスポンススキーマ ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### レスポンス例 ```json { "error": { "code": "storage_write_failed", "message": "File storage failed", "param": null, "type": "server_error" } } ``` ## cURLの例 ### curl ```curl curl -X POST https://runapi.ai/v1/files \ -H 'Authorization: Bearer YOUR_API_KEY' \ -F 'file=@./knowledge.pdf' \ -F 'purpose=user_data' ``` ## 関連リファレンス - [永続ファイル](https://runapi.ai/ja/docs/api/protocol/files.md) - [Fileオブジェクト](https://runapi.ai/ja/docs/api/protocol/files/object.md) --- ## RunAPI のその他の情報 - [ホーム](https://runapi.ai/ja/.md) - [モデルカタログ](https://runapi.ai/ja/models.md) - [料金](https://runapi.ai/ja/pricing.md) - [プロバイダー](https://runapi.ai/ja/models) - [ドキュメント](https://runapi.ai/ja/docs/guides) - [SDK](https://runapi.ai/ja/sdk.md) - [CLI](https://runapi.ai/ja/cli.md) - [MCP Server](https://runapi.ai/ja/mcp.md) - [Claude Code と Cursor](https://runapi.ai/ja/claude-code-vs-cursor.md) - [Cursor API セットアップ](https://runapi.ai/ja/cursor-api-setup.md) - [RunAPI と OpenRouter の比較](https://runapi.ai/ja/openrouter-alternative.md) - [エンタープライズ](https://runapi.ai/ja/contact.md) - [お問い合わせ](https://runapi.ai/ja/contact.md) - [利用規約](https://runapi.ai/ja/terms.md) - [プライバシー](https://runapi.ai/ja/privacy.md) - [エージェント向けサイトインデックス](https://runapi.ai/llms.txt) お問い合わせ: contact@runapi.ai ## 構造化データ ```json [ { "@context": "https://schema.org", "inLanguage": "ja", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ja", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ja/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ja", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/jaicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ja", "@type": "TechArticle", "headline": "ファイルを作成する", "description": "1つのマルチパートuser_dataまたはバッチFileを永続ストレージにストリームします。", "url": "https://runapi.ai/ja/docs/api/protocol/files/create", "mainEntityOfPage": "https://runapi.ai/ja/docs/api/protocol/files/create" } ] ```