Upload API Reference

This section explains how to upload an image for editing by sending a direct request to our API.

Uploading an image for editing via API

Image upload endpoint allows you to upload an image directly from your computer or server for editing, instead of providing an image URL.

To upload an image, attach an image file as body part of multipart/form-data. The other body part of multipart/form-data should be the same as JSON for a regular image editing request, except there is no input image URL option there. See Image edit contract for more info.

Image Edit Upload

post

Specifies:

• how the image will be processed (operations)

• where it will be stored (output)

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

To work with the Claid API, send requests over HTTPS and authenticate using the Authorization header in the following format:Authorization: Bearer <YOUR_API_KEY>. You do not need to provide a password.

To get your API key, sign in to your Claid account and click Create API key button from the Overview or API keys pages.

Claid API’s base URL is https://api.claid.ai/v1/. All available endpoints are listed in the Storage and Image sections.

Bearer

This API uses OAuth 2.0 bearer token (API key) to authorize requests.

Token URL:

Body

multipart/form-data

filestring · binaryRequired

datastringRequired

Responses

200

Successful Response

application/json

Wrapper for responses

401

Authorization is required.

application/json

402

No API calls left.

application/json

403

Not enough permissions.

application/json

422

Unprocessable Entity.

application/json

429

Too many requests.

application/json

post

/v1/image/edit/upload

HTTPcURLJavaScriptPython

POST /v1/image/edit/upload HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 31

{
  "file": "binary",
  "data": "text"
}

{
  "data": {
    "input": {
      "ext": "text",
      "mps": 1,
      "mime": "text",
      "format": "text",
      "width": 1,
      "height": 1
    },
    "output": {
      "ext": "text",
      "mps": 1,
      "mime": "text",
      "format": "text",
      "width": 1,
      "height": 1,
      "tmp_url": "text",
      "object_key": "text",
      "object_bucket": "text",
      "object_uri": "text",
      "claid_storage_uri": "text"
    },
    "profiling": {}
  }
}

Request

HTTP

POST /v1/image/edit/upload HTTP/1.1
Host: api.claid.ai
Authorization: Bearer {YOUR_API_KEY}
Content-Type: multipart/form-data; boundary="boundary"

--boundary
Content-Disposition: form-data; name="file"; filename="the_image"

< ./the_image.jpg

--boundary
Content-Disposition: form-data; name="data"
Content-Type: application/json

{
  "operations": {
    "resizing": {
      "width": 1000
    },
    "background": {
      "remove": false
    }
  }
}

--boundary--

cURL

Request headers

Content-Type: multipart/form-data; boundary="boundary"
Authorization: Bearer {YOUR_API_KEY}

In order to send a request, you should set a Content-Type header to let our system know that you are providing a valid form data payload and an Authorization header with a generated API key to identify yourself as a Claid user.

The form data payload should have two blocks of data (body parts), with a delimiter (boundary) separating each block.

The block with an image file should have a Content-Disposition header equal to form-data with two required keys: a name key with a value equal to file and a filename key that will be assigned to an output result image (it is better not to include the extension in a filename, as it can be overwritten by Output options).

Content-Disposition: form-data; name="file"; filename="the_image"

The block with edit operations should have two headers: a Content-Disposition header equal to form-data with a name key with a value equal to data and a Content-Type header to let our system know that you are providing a valid JSON payload.

Content-Disposition: form-data; name="data"
Content-Type: application/json

Response body and headers

The response body and headers is equal to response body and headers of regular image edit request. See the Read a response and Response Headers to learn more.