Create a pattern - Arcade API

POST

/

patterns

/

create

Create a pattern

curl --request POST \
  --url https://platform.arcade.ai/v1/patterns/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "<string>",
  "prompt": "<string>",
  "referenceIds": [],
  "modelId": "<string>",
  "colors": []
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    requestId: '<string>',
    prompt: '<string>',
    referenceIds: [],
    modelId: '<string>',
    colors: []
  })
};

fetch('https://platform.arcade.ai/v1/patterns/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://platform.arcade.ai/v1/patterns/create"

payload = {
    "requestId": "<string>",
    "prompt": "<string>",
    "referenceIds": [],
    "modelId": "<string>",
    "colors": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "jobId": "<string>",
  "kind": "pattern",
  "status": "running",
  "result": {
    "patternId": "<string>"
  },
  "error": {
    "message": "<string>"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

An API key from Settings → API keys in Arcade Studio.

Body

application/json

requestId

string

required

Caller-chosen idempotency key; a replay returns the original result

Required string length: 1 - 128

prompt

string

required

Required string length: 1 - 1000

referenceIds

string[]

References to guide the generation

Maximum array length: 3

Opaque ID of one uploaded reference image

Minimum string length: 1

modelId

string

A modelId from models.list; omit to let Arcade choose

Minimum string length: 1

colors

string[]

#RRGGBB hex, or Arcade palette or Pantone color tokens

Maximum array length: 10

Minimum string length: 1

Response

200 - application/json

OK

A pattern job that makes one pattern

jobId

string

required

Opaque job ID; read the job with jobs.get

Minimum string length: 1

kind

enum<string>

required

What the job makes: a pattern (patterns.create or a refine), a product (products.create) or a download (an upscale started in Arcade Studio)

Available options:

pattern,

product,

download

status

enum<string>

required

Jobs are created running; there is no queued state

Available options:

running,

succeeded,

failed

result

object

required

What a succeeded job made. Null while running, when it failed, when a deformity fix found nothing to repair, and once the pattern it made is deleted.

Option 1
Option 2
Option 3

Show child attributes

error

object | null

required

Why the job failed; set once it failed

Show child attributes

createdAt

string<date-time>

required

When the job started; for a product with no recorded build (made by Create, or built before builds were kept), when the product was created

completedAt

string<date-time> | null

required

When the job finished; null while running and for a failed product job, which does not record it

Create a pattern

curl --request POST \
  --url https://platform.arcade.ai/v1/patterns/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "<string>",
  "prompt": "<string>",
  "referenceIds": [],
  "modelId": "<string>",
  "colors": []
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    requestId: '<string>',
    prompt: '<string>',
    referenceIds: [],
    modelId: '<string>',
    colors: []
  })
};

fetch('https://platform.arcade.ai/v1/patterns/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://platform.arcade.ai/v1/patterns/create"

payload = {
    "requestId": "<string>",
    "prompt": "<string>",
    "referenceIds": [],
    "modelId": "<string>",
    "colors": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "jobId": "<string>",
  "kind": "pattern",
  "status": "running",
  "result": {
    "patternId": "<string>"
  },
  "error": {
    "message": "<string>"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z"
}