Quick start (cURL): list styles → upload → fetch result

Category: Deep Art API
Section: Getting started & authentication

Contents

• Prerequisites
• List available styles
• Upload an image with a style
• Check status & download the result
• Tips
• See also

Prerequisites

• Your API credentials from the Developer Dashboard (API Key or Access/Secret as applicable).
• cURL available in your shell.
• A test image (e.g., sample.jpg).

Some endpoints on the site are labeled /noauth/ and do not require an API key. If your call requires credentials, add the header as documented for that endpoint.

1) List available styles

Request a list of styles and pick an identifier for the next step.

curl -X GET \
  "https://api.deeparteffects.com/v1/noauth/styles"

Response (example):

[
  { "id": "abstract_1", "name": "Abstract 1" },
  { "id": "van_gogh_2", "name": "Van Gogh 2" }
]

2) Upload an image with a style

Submit your image along with the chosen styleId. The API accepts a base64‑encoded image payload as shown below.

# 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 (example):

{ "submissionId": "subm_1234567890" }

If your plan/endpoint requires authentication, include your header (for example, -H "x-api-key: YOUR_KEY").

3) Check status & download the result

Poll the job until it finishes, then download the returned URL.

curl -X GET \
  "https://api.deeparteffects.com/v1/noauth/result?submissionId=subm_1234567890"

Response while processing (example):

{ "status": "processing" }

Response when finished (example):

{
  "status": "finished",
  "url": "https://cdn.deeparteffects.com/result/subm_1234567890.png"
}

Result URLs are typically time‑limited; download promptly and store the file on your side.

Tips

• Keep your originals—you can re‑run with a different styleId without re‑encoding the image.
• For large files, ensure your shell/base64 command doesn’t insert newlines (use -w 0 on GNU base64).
• If you receive 401/403/429, see the Errors & rate limits article for diagnostics.

See also

• API overview & authentication
• Get your API credentials (dashboard)
• API usage plans — pricing & daily quotas
• Errors & rate limits — troubleshooting