Endpoint: Upload an image with a style — guide (Deep Art API)

Category: Deep Art API
Section: Endpoints (basics)

Contents

• Purpose
• HTTP request
• Authentication
• Request body
• Example (cURL)
• Response
• Errors
• See also

Purpose

Submit an input image together with a chosen style so the API can process it asynchronously.

HTTP request

POST https://api.deeparteffects.com/v1/noauth/upload

Authentication

This endpoint is available under /noauth/ and does not require an API key.

Request body

Send JSON with the following fields (as documented):

• styleId (required) — the identifier from the styles list.
• imageBase64Encoded (required) — your source image as a base64‑encoded string.
• imageSize (optional) — target size (integer).
• partnerId (optional) — string.
• optimizeForPrint (optional) — boolean.
• useOriginalColors (optional) — boolean.

Tip: Ensure your base64 string contains no line breaks. On GNU base64, use -w 0.

Example (cURL)

# macOS/Linux: create a base64 string from an image
BASE64=$(base64 -w 0 sample.jpg 2>/dev/null || base64 sample.jpg)

curl -X POST \
  "https://api.deeparteffects.com/v1/noauth/upload" \
  -H "Content-Type: application/json" \
  -d "{\
    \"styleId\": \"abstract_1\",\
    \"imageBase64Encoded\": \"$BASE64\",\
    \"imageSize\": 1024\
  }"

Response

On success, the API returns a submission identifier you can use to poll for the result.

Example:

{ "submissionId": "subm_1234567890" }

Errors

• 400 Bad Request — missing/invalid field (e.g., styleId not found or malformed JSON).
• 5xx — temporary server issue. Retry after a short delay.

If you receive 401/403 on a noauth URL, double‑check the path; the noauth variant should not require credentials.

See also

• Endpoint: List available styles — guide
• Endpoint: Check status & download result — guide
• Quick start (cURL): list styles → upload → fetch result
• Errors & rate limits — troubleshooting