Toolpaper

Send multipart form-data with cURL in Python

Paste a curl command that sends multipart form-data and get idiomatic Python code. We pick the right serialization for requests and set the correct Content-Type.

Quick answer

To convert a cURL command to Python, paste it into the Toolpaper workbench below. It parses the command in your browser and emits idiomatic Python code — headers, query string, request body, authentication (Bearer, Basic, API key), and cookies are all wired up automatically. No data is uploaded; conversion is fully client-side.

Prefer a different target? See the full cURL to Python reference, or jump to the same guide in JavaScript, Node.js, or Go.

InputcURL command
MethodPOST·Headers0·Body—·Form2 fields· Chars 100
OutputPython · requests(sync)
import requests

response = requests.post(
    "https://api.example.com/upload",
    files={
        "file": open("/path/to/photo.png", "rb"),
        "caption": (None, "Hello")
    },
)
Inspect

Example

A representative curl command for this scenario. Paste your own above to convert an exact match.

curl input
curl -X POST https://api.example.com/upload \
  -F "file=@/path/to/photo.png" \
  -F "caption=Hello"

Implementation notes

  • Content-Type is detected from -H headers first, then inferred from the body shape when the header is missing.
  • Each -F flag becomes a distinct part; file@ paths are surfaced as requests file handles so the multipart boundary stays valid.
  • Charset directives on Content-Type (e.g. application/json; charset=utf-8) survive the round trip.

Common mistakes

  • Setting Content-Type manually and then also using requests's helper — you end up with duplicate headers or the wrong one wins.
  • Forgetting @ in -F "file=@upload.png" — without it curl sends the literal string, not the file. The generator flags this.
  • Trusting the browser DevTools "Copy as cURL" to preserve charset — it often drops it. Clean panel restores common defaults.

Common questions

How is multipart form-data encoded in the generated Python?
-F flags translate to multipart form-data with proper boundary handling — files={...} in Python, MultipartFormDataContent in C#, MultipartBody.Part in Java/Kotlin.
Does it preserve Content-Type?
Yes. The Content-Type header is honored and matched against the body so serialization stays consistent.
Is anything uploaded?
No. Parsing and generation happen entirely in your browser.

More payload types in Python

Python hub →

JSON in Python

/how-to/send-json-with-curl-in-python

form-urlencoded in Python

/how-to/send-form-with-curl-in-python

XML in Python

/how-to/send-xml-with-curl-in-python

GraphQL in Python

/how-to/send-graphql-with-curl-in-python

The same guide in other languages

All guides →

In JavaScript

/how-to/send-multipart-with-curl-in-javascript

In Node.js

/how-to/send-multipart-with-curl-in-node

In Go

/how-to/send-multipart-with-curl-in-go

In PHP

/how-to/send-multipart-with-curl-in-php

In Ruby

/how-to/send-multipart-with-curl-in-ruby

In Rust

/how-to/send-multipart-with-curl-in-rust

In Java

/how-to/send-multipart-with-curl-in-java

In Kotlin

/how-to/send-multipart-with-curl-in-kotlin

Full Python reference on the cURL to Python hub, or open the main converter for all 18 targets.