=== URL: https://useapi.net/docs/start-here/setup-pika ===
Document URL: https://useapi.net/docs/start-here/setup-pika
---
layout: default
title: Setup Pika
nav_order: 600
nav_exclude: true  
---
# <img style="height:1.5em;vertical-align: middle;" src="https://useapi.net/assets/images/pika.webp"> Setup Pika 
{: .no_toc }

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

<small>Approximately 3 minutes to complete setup steps.</small>  

---

## Create Discord account

You need a [Discord](https://discord.com) account to interact with [Pika Discord Bot](http://discord.gg/pika). Create a [new account](https://discord.com/register) if you don't have one already.

Please note even if you have an existing Discord account we are **strongly** recommending creating a separate Discord account specifically designated to be used with useapi.net API.   

## Join Pika Discord Server 

Follow Pika Labs [instructions](https://pikalabsai.org/pika-labs-discord-server-guide/) and join official [Pika Discord Server](http://discord.gg/pika).

## Add Pika Bot to your Direct Messages channel

Please follow [youtube video](https://www.youtube.com/watch?v=moxSKVcQt6c) to add Pika Bot to your Direct Messages channel.

## Make a note of your Direct Messages Pika channel id

Your Discord URL looks like `https://discord.com/channels/@me/<channel_id>`.

![](../../assets/images/pika_dm_channel_setup.png)

## Obtain Discord token

There are many tutorials describing how to obtain Discord tokens. Please refer to the following links bellow for additional guidance:
- [How to Find Your Discord Token](https://discordhelp.net/discord-token)
- [How To Get Your Discord Token](https://pcstrike.com/how-to-get-discord-token/)
- [How to get Discord Token](https://linuxhint.com/get-discord-token/)

Keep in mind that anyone with a Discord token can have **full access** to your Discord account so please keep it **safe** and **secure**. To reset your Discord token simply change your Discord password.

## Verify Discord access

<script>

  async function verifyChannel() {
    const discord = document.getElementById(`channel-discord`)?.value;
    const channel = document.getElementById(`channel-channel`)?.value;      

    const data = { 
        method: 'GET',
        headers: {
          'Authorization': `${discord}`,
          'Content-Type': 'application/json'
        }
      };

      const url=`https://discord.com/api/v10/channels/${channel}`;

      await apiExecute(url, 'channel', data);
}
</script>

Once all the above steps are completed you should have the following:
- Pika Direct Message channel id number
- Discord token

This only verifies that token and channel id values are correct. To complete setup, you **MUST** proceed to [POST account/`channel`](../api-pika-v1/post-pika-account-channel) and complete the configuration of the Pika API account using the token and channel id values retrieved above.

##### Channel
{: .no_toc }

<form id="channel" onsubmit="return false;" class="input-form">
  <div class="input-field">
    <div class="input-field-row">
      <label for="channel-discord"><span>Discord token</span>
        <input id="channel-discord" type="text"  class="input-element" required aria-required="true" oninput="this.size = this.value.length"> 
      </label>
      <label for="channel-channel"><span>Discord channel id</span>
        <input id="channel-channel" type="text"  class="input-element" required aria-required="true" oninput="this.size = this.value.length"> 
      </label>
    </div>
    <button id="channel-button" class="btn btn-primary fs-3" type="submit" onclick="verifyChannel()">Go</button>
  </div>
</form>

<div id="channel-response" class="response-placeholder visible-false"></div>

=== URL: https://useapi.net/docs/api-pika-v1 ===
Document URL: https://useapi.net/docs/api-pika-v1
---
layout: default
title: Pika API v1
nav_order: 11000
has_children: true
permalink: /docs/api-pika-v1
nav_exclude: true
---

# <img style="height:1.5em;vertical-align: middle;" src="https://useapi.net/assets/images/pika.webp"> Pika API v1 
<small>January 2024 (December 15, 2025)</small>

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

This is [experimental](../../docs/legal) API for [Pika Discord Bot](http://discord.gg/pika) by [Pika.art](https://pika.art). Pika currently support text and images as input for video generation, and private generations by directly messaging the bot. 

[Setup Pika](../../docs/start-here/setup-pika)

[Postman collection](https://www.postman.com/useapinet/useapi-net/collection) <small>(January 20, 2026)</small>  

#### Example source code on GitHub 
* [Face swap and animate images generated by Midjourney using InsightFaceSwap and Pika (using webhook)](https://github.com/useapi/examples/tree/main/imagine-faceswap-animate) February 19, 2024
* [Animate images generated by Midjourney using Pika (using webhook)](https://github.com/useapi/examples/tree/main/animate-midjourney-images-with-pika) January 29, 2024

Developer Community:
* <a href="https://discord.gg/w28uK3cnmF"><img style="height:1em;vertical-align: middle;" src="https://useapi.net/assets/images/discord.svg"> Discord Server</a>
* <a href="https://t.me/use_api"><img style="height:1.3em;vertical-align: middle;" src="https://useapi.net/assets/images/telegram.svg"> Telegram Channel</a>
* <a href="https://www.reddit.com/r/aiAPI"><img style="height:1.3em;vertical-align: middle;" src="https://useapi.net/assets/images/reddit.svg"> Reddit Group</a>


=== URL: https://useapi.net/docs/api-pika-v1/del-pika-account-channel ===
Document URL: https://useapi.net/docs/api-pika-v1/del-pika-account-channel
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-delete">DEL</code> pika/account/<code class="language-plaintext highlighter-rouge">channel</code>
parent: Pika API v1
nav_order: 400
nav_exclude: true
---
## Delete Pika account
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

{: .delete }
> **https://api.useapi.net/v1/pika/account/`channel`**

The `channel` value should correspond to an account configured previously via a [POST](post-pika-account-channel) request.

##### Request Headers
``` yaml
Authorization: Bearer {API token}
```

- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Responses 

{% tabs del_account_Pika_response %}

{% tab del_account_Pika_response <span class="http-status-good">204</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/204" rel="noreferrer" target="_blank"><span class="http-status-good">204 No Content</span></a> 

{% endtab %}

{% tab del_account_Pika_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>
```json
{
  "error": "Unauthorized",
  "code": 401
}
```
{% endtab %}

{% tab del_account_Pika_response <span class="http-status-bad">404</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404" rel="noreferrer" target="_blank"><span class="http-status-bad">404 Not Found</span></a>

{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  error: string,
  errorDetails: string,
  code: number
}
```

##### Examples

{% tabs del_account_Pika_example %}

{% tab del_account_Pika_example Curl %}
``` bash
curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer …" \
     -X DELETE https://api.useapi.net/v1/pika/account/<channel> 
```
{% endtab %}

{% tab del_account_Pika_example JavaScript %}
``` javascript
const channel = "Previously configured channel id"; 
const apiUrl = `https://api.useapi.net/v1/pika/account/${channnel}`; 
const token = "API token";
const data = { 
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json' }
};
const response = await fetch(apiUrl, data);
const result = await response.json();
console.log("response", {response, result});
```
{% endtab %}

{% tab del_account_Pika_example Python %}
``` python
import requests
channel = "Previously configured channel id" 
apiUrl = f"https://api.useapi.net/v1/pika/account/{channel}" 
token = "API token"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.delete(apiUrl, headers=headers)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/get-pika-account-channel ===
Document URL: https://useapi.net/docs/api-pika-v1/get-pika-account-channel
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-get">GET</code> pika/account/<code class="language-plaintext highlighter-rouge">channel</code>
parent: Pika API v1
nav_order: 200
nav_exclude: true
---
## Retrieve Pika configuration for `channel` 
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

{: .get }
> **https://api.useapi.net/v1/pika/account/`channel`**

The `channel` value should correspond to an account configured previously via a [POST](post-pika-account-channel) request.

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: application/json
```

- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Responses 

{% tabs get_account_Pika_channel_response %}

{% tab get_account_Pika_channel_response <span class="http-status-good">200</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>
```json
{
  "channel": "Discord channel id",
  "discord": "Discord token",
  "maxJobs": 1-10
}
```
{% endtab %}

{% tab get_account_Pika_channel_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>
```json
{
  "error": "Unauthorized",
  "code": 401
}
```
{% endtab %}

{% tab get_account_Pika_channel_response <span class="http-status-bad">404</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404" rel="noreferrer" target="_blank"><span class="http-status-bad">404 Not Found</span></a>  

Configuration not found. To create configuration use [pika/account/`channel`](https://useapi.net/docs/api-pika-v1/post-pika-account-channel).

{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  discord: string, 
  channel: string,
  maxJobs: number,
}
```

##### Examples

{% tabs get_account_Pika_channel_example %}

{% tab get_account_Pika_channel_example Curl %}
``` bash
curl https://api.useapi.net/v1/pika/account/<channel> \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 
```
{% endtab %}

{% tab get_account_Pika_channel_example JavaScript %}
``` javascript
const token = "API token";
const channel = "Previously configured channel id"; 
const apiUrl = `https://api.useapi.net/v1/pika/account/${channel}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});
```
{% endtab %}

{% tab get_account_Pika_channel_example Python %}
``` python
import requests
token = "API token"
channel = "Previously configured channel id"
apiUrl = f"https://api.useapi.net/v1/pika/account/{channel}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/get-pika-account ===
Document URL: https://useapi.net/docs/api-pika-v1/get-pika-account
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-get">GET</code> pika/account
parent: Pika API v1
nav_order: 100
nav_exclude: true
---
## Retrieve Pika accounts information
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

For your convenience, you can specify your Pika configuration values under your Pika account. If you specify multiple Pika accounts, the API will automatically perform load balancing by randomly selecting an account with available capacity before making calls to Discord / Pika.

This endpoint retrieves the complete list of configured accounts for Pika.

{: .get }
> **https://api.useapi.net/v1/pika/account**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: application/json
```

- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Responses 

{% tabs account_Pika_response %}

{% tab account_Pika_response <span class="http-status-good">200</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>
```json
{
    "Discord channel A": {
        "channel": "Discord channel A",
        "discord": "Discord token A",
        "maxJobs": 1-10
    },
    "Discord channel B": {
        "channel": "Discord channel B",
        "discord": "Discord token B",
        "maxJobs": 1-10
    },
    "Discord channel N": {
        "channel": "Discord channel N",
        "discord": "Discord token N",
        "maxJobs": 1-10
    }    
}
```
{% endtab %}

{% tab account_Pika_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>
```json
{
  "error": "Unauthorized",
  "code": 401
}
```
{% endtab %}

{% tab account_Pika_response <span class="http-status-bad">404</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404" rel="noreferrer" target="_blank"><span class="http-status-bad">404 Not Found</span></a>

Configuration not found. To create configuration use [pika/account/`channel`](https://useapi.net/docs/api-pika-v1/post-pika-account-channel).

{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  [channel: string]: {
    discord: string, 
    channel: string,
    maxJobs: number
  }
}
```

##### Examples

{% tabs account_Pika_example %}

{% tab account_Pika_example Curl %}
``` bash
curl https://api.useapi.net/v1/pika/account \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 
```
{% endtab %}

{% tab account_Pika_example JavaScript %}
``` javascript
const token = "API token";
const apiUrl = "https://api.useapi.net/v1/pika/account"; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});
```
{% endtab %}

{% tab account_Pika_example Python %}
``` python
import requests
token = "API token"
apiUrl = "https://api.useapi.net/v1/pika/account"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/get-pika-jobid ===
Document URL: https://useapi.net/docs/api-pika-v1/get-pika-jobid
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-get">GET</code> pika/jobs/?jobid=<code class="language-plaintext highlighter-rouge">jobid</code>
parent: Pika API v1
nav_order: 1000
nav_exclude: true
---

## Retrieve Pika job status and results
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

Use this endpoint to retrieve status and results of 
- [pika/create](../api-pika-v1/post-pika-create)
- [pika/animate](../api-pika-v1/post-pika-animate)
- [pika/encrypt_text](../api-pika-v1/post-pika-encrypt_text)
- [pika/encrypt_image](../api-pika-v1/post-pika-encrypt_image)
- [pika/button](../api-pika-v1/post-pika-button)

If you specified optional parameter [`replyUrl`](../api-pika-v1/post-pika-create#request-body) you technically do not need to use this endpoint to retrieve results since API will call provided `replyUrl` once job generation completed.

**Important** API periodically polls (checks) Discord every 15 to 60 seconds (depending on the load) and updates all currently executed jobs statuses and results. Polling interval is used for safety reasons, aiming to prevent any potential issues with Discord and Pika, such as bans or excessive requests.

Jobs lifespan guaranteed to be at least 31 days, after that they will be expired and may be recycled.

{: .get }
> **https://api.useapi.net/v1/pika/jobs/?jobid=`jobid`**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Query Parameter
`jobid` is **required**, use value returned by 
- [pika/create](../api-pika-v1/post-pika-create)
- [pika/animate](../api-pika-v1/post-pika-animate)
- [pika/encrypt_text](../api-pika-v1/post-pika-encrypt_text)
- [pika/encrypt_image](../api-pika-v1/post-pika-encrypt_image)
- [pika/button](../api-pika-v1/post-pika-button)

##### Responses 
{:toc}

{% tabs get_pika_jobid_response %}

{% tab get_pika_jobid_response <span class="http-status-good">200</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>

If field `status` value is *created*, *started* or *progress* wait in a loop for **at least** 10..30 seconds and retry again. When completed retrieve generated video from `attachments` field. Field `content` contains message generated by Pika reflecting current generation parameters and progress. Optional array `embeds` contains additional information.  

```json
{
    "jobid": "<jobid>",
    "verb": "pika-create",
    "status": "completed",
    "created": "2023-09-09T02:04:49.667Z",
    "updated": "2023-09-09T02:19:20.256Z",
    "prompt": "smiling and blinking",
    "buttons": [ "retry" ],
    "image": { "size": 1628384, "type": "image/png" },
    "discord": "<ABC…secured…xyz>",
    "channel": "<Discord channel id>",
    "maxJobs": 10,
    "messageId": "<Discord message id>",
    "content": "<@Discord user id> Prompt: smiling and blinking --size 100  Image: 1 Attachment  Author: <@Discord user id>)",
    "timestamp": "2023-09-09T02:05:24.991000+00:00",
    "attachments": [
        {
            "url": "<generated video url>",
            "proxy_url": "<generated proxy video url>",
            "width": 768,
            "height": 768,
            "content_type": "<generated video type>",
            "id": "<Discord attachment id>",
            "filename": "<generated video filename>",
            "size": 7204115
        }
    ],
    "code": 200
}
```
{% endtab %}

{% tab get_pika_jobid_response <span class="http-status-bad">400</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>

```json
{
    "error": "Query param jobid not provided",
    "code": 400
}
```
{% endtab %}

{% tab get_pika_jobid_response <span class="http-status-bad">401</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```

{% endtab %}

{% tab get_pika_jobid_response <span class="http-status-bad">402</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```
{% endtab %}


{% tab get_pika_jobid_response <span class="http-status-bad">404</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404" rel="noreferrer" target="_blank"><span class="http-status-bad">404 Not Found</span></a>

```json
{
    "error": "Unable to locate job <jobid>",
    "code": 404
}
```

{% endtab %}

{% tab get_pika_jobid_response <span class="http-status-bad">410</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/410" rel="noreferrer" target="_blank"><span class="http-status-bad">410 Gone</span></a>

```json
{
    "error": "Job has expired",
    "code": 410
}
```

{% endtab %}

{% endtabs %}

##### Model
```typescript
{ // TypeScript, all fields are optional
  jobid: string,
  parentJobId: string,
  verb: 'pika-create' | 'pika-animate' | 'pika-encrypt_text' | 'pika-encrypt_image' | 'pika-button',
  status: 'created' | 'started' | 'moderated' | 'progress' | 
          'completed' | 'failed' | 'cancelled',
  created: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  updated: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  prompt: string,
  font: 'MODERN' | 'COMICS' | 'SANS SERIF' | 'BAUHAUS' | 'RETRO',
  message: string | { size: number, type: string },
  image: { size: number, type: string
  },
  button: 'retry',
  buttons: [ 'retry' ],
  discord: string, // Provided for debugging purposes only, contains the first 3 and the last 3 characters of the original value
  channel: string,
  maxJobs: number,
  messageId: string,
  content: string, // Contains message generated by Pika reflecting current generation parameters and progress
  timestamp: string,
  attachments: [
      {
          id: string,
          content_type: string,
          filename: string,
          url: string,
          proxy_url: string,
          size: number,
          width: number,
          height: number
      }
  ],
  embeds: [
      {
          type: string,
          description: string,
          image: {
              url: string,
              proxy_url: string,
              width: number,
              height: number
          }
      }
  ], 
  error: string,
  errorDetails: string,
  code: 200
}
```

##### Examples

{% tabs pika_jobid_example %}

{% tab pika_jobid_example Curl %}
``` bash
curl https://api.useapi.net/v1/pika/jobs/?jobid=… \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 
```
{% endtab %}

{% tab pika_jobid_example JavaScript %}
``` javascript
const token = "API token";
const jobid = "jobid returned by pika/create, pika/animate, pika/encrypt_text, pika/encrypt_image' or pika/button";      
const apiUrl = `https://api.useapi.net/v1/pika/jobs/?jobid=${jobid}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});
```
{% endtab %}

{% tab pika_jobid_example Python %}
``` python
import requests
token = "API token"
jobid = "jobid returned by pika/create, pika/animate, pika/encrypt_text, pika/encrypt_image' or pika/button"
apiUrl = f"https://api.useapi.net/v1/pika/jobs/?jobid={jobid}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/get-pika-jobs-cancel ===
Document URL: https://useapi.net/docs/api-pika-v1/get-pika-jobs-cancel
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-get">GET</code> …/cancel/?jobid=<code class="language-plaintext highlighter-rouge">jobid</code>
parent: Pika API v1
nav_order: 2000
nav_exclude: true
---

## Cancel Pika job
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

<small>✔️ Added May 27, 2024</small>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

Cancel execution of job created by 
- [pika/create](post-pika-create)
- [pika/animate](post-pika-animate)
- [pika/encrypt_text](post-pika-encrypt_text)
- [pika/encrypt_image](post-pika-encrypt_image)
- [pika/button](post-pika-button)

{: .get }
> **https://api.useapi.net/v1/pika/jobs/cancel/?jobid=`jobid`**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Query Parameter
`jobid` is **required**, use value returned by 
- [pika/create](post-pika-create)
- [pika/animate](post-pika-animate)
- [pika/encrypt_text](post-pika-encrypt_text)
- [pika/encrypt_image](post-pika-encrypt_image)
- [pika/button](post-pika-button)

##### Responses 
{:toc}

{% tabs post_pika_cancel_response %}

{% tab post_pika_cancel_response <span class="http-status-good">200</span> %}

```json
{
    "jobid": "<jobid>",
    "status": "cancelled"
}   "code": 200
```

{% endtab %}

{% tab post_pika_cancel_response <span class="http-status-bad">400</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>

```json
{
    "error": "Query param jobid not provided",
    "code": 400
}
```

{% endtab %}

{% tab post_pika_cancel_response <span class="http-status-bad">401</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```

{% endtab %}

{% tab post_pika_cancel_response <span class="http-status-bad">402</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```

{% endtab %}


{% tab post_pika_cancel_response <span class="http-status-bad">404</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404" rel="noreferrer" target="_blank"><span class="http-status-bad">404 Not Found</span></a>

```json
{
    "error": "Unable to locate job <jobid>",
    "code": 404
}
```

{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  jobid: string, 
  status: 'created' | 'started' | 'moderated' | 'progress' | 
          'completed' | 'failed' | 'cancelled',
  error: string,
  errorDetails: string,
  code: number
}
```

##### Examples

{% tabs pika_cancel_example %}

{% tab pika_cancel_example Curl %}
``` bash
curl https://api.useapi.net/v1/pika/jobs/cancel/?jobid=… \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 
```
{% endtab %}

{% tab pika_cancel_example JavaScript %}
``` javascript
const token = "API token";
const jobid = "jobid returned by pika/create, pika/animate, pika/encrypt_text, pika/encrypt_image or pika/button";      
const apiUrl = `https://api.useapi.net/v1/pika/jobs/cancel/?jobid=${jobid}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});
```
{% endtab %}

{% tab pika_cancel_example Python %}
``` python
import requests
token = "API token"
jobid = "jobid returned by pika/create, pika/animate, pika/encrypt_text, pika/encrypt_image or pika/button"
apiUrl = f"https://api.useapi.net/v1/pika/jobs/cancel/?jobid={jobid}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/get-pika-jobs ===
Document URL: https://useapi.net/docs/api-pika-v1/get-pika-jobs
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-get">GET</code> pika/jobs
parent: Pika API v1
nav_order: 3000
nav_exclude: true
---

## Get list of currently executing Pika jobs
{: .no_toc }
 
<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

<small>✔️ Added May 27, 2024</small>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

{: .get }
> **https://api.useapi.net/v1/pika/jobs**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Responses 
{:toc}

{% tabs post_pika_jobs_response %}

{% tab post_pika_jobs_response <span class="http-status-good">200</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>

```json
[ "<jobid>", "<jobid>", "<jobid>" ]
```

{% endtab %}

{% tab post_pika_jobs_response <span class="http-status-bad">401</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```

{% endtab %}

{% tab post_pika_jobs_response <span class="http-status-bad">402</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```

{% endtab %}

{% endtabs %}

##### Model
```typescript
// TypeScript
string[]
```

##### Examples

{% tabs pika_jobs_example %}

{% tab pika_jobs_example Curl %}
``` bash
curl https://api.useapi.net/v1/pika/jobs \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 
```
{% endtab %}

{% tab pika_jobs_example JavaScript %}
``` javascript
const token = "API token";
const apiUrl = `https://api.useapi.net/v1/pika/jobs`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});
```
{% endtab %}

{% tab pika_jobs_example Python %}
``` python
import requests
token = "API token"
apiUrl = f"https://api.useapi.net/v1/pika/jobs"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/post-pika-account-channel ===
Document URL: https://useapi.net/docs/api-pika-v1/post-pika-account-channel
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-post">POST</code> pika/account/<code class="language-plaintext highlighter-rouge">channel</code>
parent: Pika API v1
nav_order: 300
nav_exclude: true
---
## Create or update Pika account information
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

For your convenience, you can specify your Pika configuration values under your account. If you specify multiple Pika accounts, the API will automatically perform load balancing by randomly selecting an account with available capacity before making calls to Discord / Pika.

{: .post }
> **https://api.useapi.net/v1/pika/account/`channel`**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: application/json
```

- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Request Body
```json
{
    "discord": "Discord token",
    "channel": "Discord channel id",
    "maxJobs": 1-10,
}
```
- `discord`, `channel` are **required**. Please see [Setup Pika](../start-here/setup-pika) for details. 

- `channel` value specified in the request body **must match** the channel value specified in the URL path https://api.useapi.net/v1/pika/account/`channel`.

- `maxJobs` is **required**. Currently, it should be between 1 and 10.

##### Responses 

{% tabs post_account_Pika_response %}

{% tab post_account_Pika_response <span class="http-status-good">204</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/204" rel="noreferrer" target="_blank"><span class="http-status-good">204 No Content</span></a> 

{% endtab %}

{% tab post_account_Pika_response <span class="http-status-bad">400</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>
```json
{
  "error": 
    "Required param discord is missing or empty"
    "Required param channel is missing or empty"
    "Required param channel (<channel>) is not valid Discord channel id"
    "Required param channel (<channel>) not matching to /pika/account/<channel>"
    "Required param maxJobs is missing or empty"
    "Required param maxJobs <maxJobs> can't be more that <maxConcurrentJobs>"
    "Channel <channel> configuration has same discord value"
  "code": 400
}
```
{% endtab %}

{% tab post_account_Pika_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>
```json
{
  "error": "Unauthorized",
  "code": 401
}
```
{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  discord: string, 
  channel: string,
  maxJobs: number,
  error: string,
  errorDetails: string,
  code: number
}
```

##### Examples

{% tabs post_account_Pika_example %}

{% tab post_account_Pika_example Curl %}
``` bash
curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/pika/account/<channel> \
     -d '{"discord": "…", "channel": "…", "maxJobs": …}'
```
{% endtab %}

{% tab post_account_Pika_example JavaScript %}
``` javascript
const channel = "Discord channel id";      
const apiUrl = `https://api.useapi.net/v1/pika/account/${channel}`; 
const token = "API token";
const discord = "Discord token";
const maxJobs = 10;
const data = { 
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json' }
};
data.body = JSON.stringify({ 
  discord, channel, maxJobs
});
const response = await fetch(apiUrl, data);
const result = await response.json();
console.log("response", {response, result});
```
{% endtab %}

{% tab post_account_Pika_example Python %}
``` python
import requests
channel = "Discord channel id"
apiUrl = f"https://api.useapi.net/v1/pika/account/{channel}" 
token = "API token"
discord = "Discord token"
maxJobs = 10
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
body = {
    "discord": f"{discord}", 
    "channel": f"{channel}",
    "maxJobs": maxJobs
}
response = requests.post(apiUrl, headers=headers, json=body)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/post-pika-animate ===
Document URL: https://useapi.net/docs/api-pika-v1/post-pika-animate
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-post">POST</code> pika/animate
parent: Pika API v1
nav_order: 600
nav_exclude: true
---
## Pika [/animate](https://pikalabsai.org/pika-labs-commands-and-parameters) command 
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

Use this endpoint to submit the Pika [/animate](https://pikalabsai.org/pika-labs-commands-and-parameters) command to your [Discord Pika channel](../start-here/setup-pika). Results obtained as a callback via optional parameter [`replyUrl`](#request-body) or by querying [pika/jobs/?jobid=<code class="language-plaintext highlighter-rouge">jobid</code>](../api-pika-v1/get-pika-jobid) endpoint.  

It is **important** not to use the Pika account setup for API access for any purposes other than its intended use, such as executing `/animate` or any other Pika commands _manually_ or in conjunction with _any other_ automation tools. The useapi.net API internally tracks the usage of the Pika account, including the number of currently active executions. Using it for other activities may cause API to function incorrectly.

{: .post }
> **https://api.useapi.net/v1/pika/animate**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: multipart/form-data
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Request Body
```json
{
    "image": "Pika image File or Blob",
    "prompt": "Pika prompt",
    "discord": "Discord token",
    "channel": "Discord channel id",
    "maxJobs": 10,
    "replyUrl": "Place your call back URL here",
    "replyRef": "Place your reference id here"
}
```
- `image` is **required**, use it to prompt the Pika Bot to begin your video with the provided image. Must be either a [File](https://developer.mozilla.org/en-US/docs/Web/API/File) or [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) object when included in this [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) POST request.

- `prompt` is optional, must contain Pika [/animate](https://pikalabsai.org/pika-labs-commands-and-parameters) prompt.  
  Maximum length 1500 characters.  

- `discord`, `channel` are optional, if not provided randomly selected available account from [pika/account](../api-pika-v1/get-pika-account) will be used. See [Setup Pika](../start-here/setup-pika) for details.    
**Note** You may specify the `channel` value alone (omitting `discord`) when you wish to use a specific account from the configured list at [pika/account](../api-pika-v1/get-pika-account).

- `maxJobs` is optional, if not provided value for `channel` account selected above will be used, if not provided defaulted to 10.  

- `replyUrl` is optional, if not provided value from [useapi.net account](../account-management/get-account) will be used.  
  Place here your callback URL. API will call the provided `replyUrl` once job completed or failed.  
  Maximum length 1024 characters.  
  We recommend using sites like [webhook.site](https://webhook.site) to test callback URL functionality.  

 - `replyRef` is optional, place here your reference id which will be stored and returned along with this job response / result.  
  Maximum length 1024 characters.  
  
##### Responses 

{% tabs post_pika-animate_response %}

{% tab post_pika-animate_response <span class="http-status-good">200</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>

Use returned `jobid` to [retrieve Pika job status and results](../api-pika-v1/get-pika-jobid). `content` contains message generated by Pika reflecting current generation parameters and progress.

```json
{
    "jobid": "<jobid>",
    "verb": "pika-animate",
    "status": "started",
    "created": "2023-09-09T02:04:49.667Z",
    "updated": "2023-09-09T02:04:53.490Z",
    "image": { "size": 1628384, "type": "image/png" },
    "prompt": "smiling and blinking",
    "discord": "<ABC…secured…xyz>",
    "channel": "<Discord channel id>",
    "maxJobs": 10,
    "replyUrl": "https://webhook.site/abc",
    "replyRef": "<your optional reference id>",
    "messageId": "<Discord message id>",
    "content": "<@Discord user id> Creation job queued. (Prompt: smiling and blinking  Image: 1 Attachment  Author: <@Discord user id>)",
    "timestamp": "2023-09-09T02:04:51.926000+00:00",
    "code": 200
}
```
{% endtab %}

{% tab post_pika-animate_response <span class="http-status-bad">400</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>

```json
{
    "error": 
      "image, discord or channel value is missing"
      "prompt, replyRef or replyUrl is too long"
      "image is not File or Blob"
    "code": 400
}
```
{% endtab %}


{% tab post_pika-animate_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```
{% endtab %}

{% tab post_pika-animate_response <span class="http-status-bad">402</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```
{% endtab %}

{% tab post_pika-animate_response <span class="http-status-bad">422</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422" rel="noreferrer" target="_blank"><span class="http-status-bad">422 Unprocessable Content</span></a>

Moderated message or invalid prompt params.

```json
{
    "error": "Sorry, your input may be inconsistent with server rules.",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```

```json
{
    "error": "Invalid parameter",
    "errorDetails": "Unrecognized parameter(s): `size`",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```
{% endtab %}

{% tab post_pika-animate_response <span class="http-status-bad">429</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429" rel="noreferrer" target="_blank"><span class="http-status-bad">429 Too Many Requests</span></a>

Wait in a loop for **at least** 10..30 seconds and retry again.

There are two possible cases for API response 429.

1. API query is full and can not accept new [pika/animate](#pika-animate-command) requests. Size of query defined by [`maxJobs` optional parameter](#request-body). Wait in a loop for **at least** 10..30 seconds and retry again.
```json
{
    "error": "Maximum of <maxJobs> jobs executing in parallel supported",
    "executingJobs": [
      "<jobid>",
      "<jobid>",
      "<jobid>"
    ],
    "code": 429
}
```
2. The API received an HTTP status 429 from the Discord API when it attempted to POST to the `/interactions` endpoint. Under normal circumstances, this should be a rare occurrence because the API is designed to strictly adhere to Discord rate limits. However, in certain scenarios, Discord may still issue a 429 response.
```json
{
    "error": "Discord /interactions failed with HTTP status 429",
    "errorDetails": "{\"global\":true,\"message\":\"You are being rate limited.\",\"retry_after\":10}",
    "code": 429
}
```
{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  jobid: string, // Use returned jobid value to retrieve job status and results
  verb: 'pika-animate',
  status: 'started' | 'moderated' | 'failed',
  created: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  updated: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  image: { size: number, type: string },
  prompt: string,
  discord: string, // Provided for debugging purposes only, contains the first 3 and the last 3 characters of the original value
  channel: string,
  maxJobs: number,
  replyUrl: string,
  replyRef: string,
  messageId: string,
  content: string, // Contains message generated by Pika reflecting current generation parameters and progress
  timestamp: string,
  error: string,
  errorDetails: string,
  executingJobs: string[],
  code: number
}
```

##### Examples

{% tabs pika-animate_example %}

{% tab pika-animate_example Curl %}
``` bash
curl -H "Accept: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/pika/animate \
     -F "discord=<Discord token>" \
     -F "channel=<Discord channel id>" \
     -F 'image=@"<Path to the image>"' \
     -F "prompt=<Pika prompt>" 
```
{% endtab %}

{% tab pika-animate_example JavaScript %}
``` javascript
const main = async () => {
    const apiUrl = "https://api.useapi.net/v1/pika/animate";
    const token = "API token";
    const prompt = "Pika prompt";
    const discord = "Discord token";
    const channel = "Discord channel";
    const data = {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${token}`
        }
    };
    const formData = new FormData();
    formData.append("prompt", prompt);
    formData.append("discord", discord);
    formData.append("channel", channel);
    /*
        // Example 1: Fetch image from URL
        const imageUrl = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg";
        const responseImage = await fetch(imageUrl);
        formData.append("image", await responseImage.blob());
    */
    /* 
        // Example 2: Load image from local file (Blob)
        const fsp = require('fs').promises;
        const imageFileName = "./pika.webp";
        const blob = new Blob([await fsp.readFile(imageFileName)]);
        formData.append("image", blob);
    */
    /*
        // Example 3: Load from input file html element
        // <input id="pika-animate-image-url" type="file"> 
        const imageFile = document.getElementById(`pika-animate-image-file`);
        if (imageFile.files[0])
            formData.append("image", imageFile.files[0]);
    */
    data.body = formData;
    const response = await fetch(apiUrl, data);
    const result = await response.json();
    console.log("response", { response, result });
};
main()
```
{% endtab %}

{% tab pika-animate_example Python %}
``` python
import requests

api_url = "https://api.useapi.net/v1/pika/animate"
token = "API token"
prompt = "Pika prompt"
discord = "Discord token"
channel = "Discord channel"

headers = {
    'Authorization': f'Bearer {token}'
}

files = {
    'prompt': (None, prompt),
    'discord': (None, discord),
    'channel': (None, channel)
}

# # Example 1: Fetch image from URL
# image_url = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg"
# response_image = requests.get(image_url)
# image_content = response_image.content
# files['image'] = ('image.jpg', image_content, 'image/jpeg')

# # Example 2: Load image from local file
# image_file_path = "./pika.webp"
# with open(image_file_path, 'rb') as image_file:
#     files['image'] = ('pika.webp', image_file.read(), 'image/webp')

response = requests.post(api_url, headers=headers, files=files)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/post-pika-button ===
Document URL: https://useapi.net/docs/api-pika-v1/post-pika-button
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-post">POST</code> pika/button
parent: Pika API v1
nav_order: 900
nav_exclude: true
---
## [Pika](https://pikalabsai.org/pika-labs-commands-and-parameters) button command 
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

Use this endpoint to submit the Pika button command to your [Discord Pika channel](../start-here/setup-pika). Results obtained as a callback via optional parameter [`replyUrl`](#request-body) or by querying [pika/jobs/?jobid=<code class="language-plaintext highlighter-rouge">jobid</code>](../api-pika-v1/get-pika-jobid) endpoint.  

Currently only the `retry` button is supported. The API does not support the `remix` button. Since both buttons simply offer a convenient way of rerunning a job without the need to re-upload content, this limitation does not result in any loss of functionality.

It is **important** not to use the Pika account setup for API access for any purposes other than its intended use, such as executing `/button` or any other Pika commands _manually_ or in conjunction with _any other_ automation tools. The useapi.net API internally tracks the usage of the Pika account, including the number of currently active executions. Using it for other activities may cause API to function incorrectly.

{: .post }
> **https://api.useapi.net/v1/pika/button**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: multipart/form-data
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Request Body
```json
{
    "jobid": "jobid",
    "button": "button",
    "discord": "Discord token",
    "maxJobs": 10,
    "replyUrl": "Place your call back URL here",
    "replyRef": "Place your reference id here"
}
```
- `jobid` is **required**, `jobid` of successfully completed (`status` set to [*completed*](../api-pika-v1/get-pika-jobid#model) [pika/create](../api-pika-v1/post-pika-create), [pika/animate](../api-pika-v1/post-pika-animate), [pika/encrypt_text](../api-pika-v1/post-pika-encrypt_text), [pika/encrypt_image](../api-pika-v1/post-pika-encrypt_image) or [pika/button](../api-pika-v1/post-pika-button) job.

- `button` is **required**, button from buttons array of job referenced via `jobid` above, see [*button*](#model).

- `discord` is optional, if provided will override `discord` value of referenced above `jobid`, see [Setup Pika](../start-here/setup-pika) for details. If the `channel` corresponding to the `jobid` mentioned above has an account configured under [pika/account](../api-pika-v1/get-pika-account), the current account's `discord` value will be used if it is not explicitly provided. This ensures that even jobs executed some time ago can still be successfully executed by this endpoint, even after possible changes to the account's `discord` value.

- `maxJobs` is optional, if provided will override `maxJobs` value of referenced above `jobid`, if not provided defaulted to 10.  

- `replyUrl` is optional, if not provided value from [useapi.net account](../account-management/get-account) will be used.  
  Place here your callback URL. API will call the provided `replyUrl` once job completed or failed.  
  Maximum length 1024 characters.  
  We recommend using sites like [webhook.site](https://webhook.site) to test callback URL functionality.  

 - `replyRef` is optional, place here your reference id which will be stored and returned along with this job response / result.  
  Maximum length 1024 characters.  
  
##### Responses 

{% tabs post_pika-button_response %}

{% tab post_pika-button_response <span class="http-status-good">200</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>

Use returned `jobid` to [retrieve Pika job status and results](../api-pika-v1/get-pika-jobid). `content` contains message generated by Pika reflecting current generation parameters and progress.

```json
{
    "jobid": "<jobid>",
    "verb": "pika-button",
    "status": "started",
    "created": "2023-09-09T02:04:49.667Z",
    "updated": "2023-09-09T02:04:53.490Z",
    "button": "retry",
    "parentJobId": "<jobid>",
    "discord": "<ABC…secured…xyz>",
    "channel": "<Discord channel id>",
    "maxJobs": 10,
    "replyUrl": "https://webhook.site/abc",
    "replyRef": "<your optional reference id>",
    "messageId": "<Discord message id>",
    "content": "<@Discord user id>  Creation job queued. (Prompt: waves crashing over the sandy beach, overhead shot -w 2 -size 100  Message: 1 Attachment  Image: 1 Attachment  Author: <@Discord user id>)",
    "timestamp": "2023-09-09T02:04:51.926000+00:00",
    "code": 200
}
```
{% endtab %}

{% tab post_pika-button_response <span class="http-status-bad">400</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>

```json
{
    "error": 
      "jobid or button value is missing"
      "button <button> not supported"
      "replyRef or replyUrl is too long"
    "code": 400
}
```
{% endtab %}


{% tab post_pika-button_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```
{% endtab %}

{% tab post_pika-button_response <span class="http-status-bad">402</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```
{% endtab %}

{% tab post_pika-button_response <span class="http-status-bad">429</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429" rel="noreferrer" target="_blank"><span class="http-status-bad">429 Too Many Requests</span></a>

Wait in a loop for **at least** 10..30 seconds and retry again.

There are two possible cases for API response 429.

1. API query is full and can not accept new [pika/button](#pika-button-command) requests. Size of query defined by [`maxJobs` optional parameter](#request-body). Wait in a loop for **at least** 10..30 seconds and retry again.
```json
{
    "error": "Maximum of <maxJobs> jobs executing in parallel supported",
    "executingJobs": [
      "<jobid>",
      "<jobid>",
      "<jobid>"
    ],
    "code": 429
}
```
2. The API received an HTTP status 429 from the Discord API when it attempted to POST to the `/interactions` endpoint. Under normal circumstances, this should be a rare occurrence because the API is designed to strictly adhere to Discord rate limits. However, in certain scenarios, Discord may still issue a 429 response.
```json
{
    "error": "Discord /interactions failed with HTTP status 429",
    "errorDetails": "{\"global\":true,\"message\":\"You are being rate limited.\",\"retry_after\":10}",
    "code": 429
}
```
{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  jobid: string, // Use returned jobid value to retrieve job status and results
  verb: 'pika-button',
  status: 'started' | 'moderated' | 'failed',
  created: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  updated: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  button: 'retry',
  parentJobId: string,
  discord: string, // Provided for debugging purposes only, contains the first 3 and the last 3 characters of the original value
  channel: string,
  maxJobs: number,
  replyUrl: string,
  replyRef: string,
  messageId: string,
  content: string, // Contains message generated by Pika reflecting current generation parameters and progress
  timestamp: string,
  error: string,
  errorDetails: string,
  executingJobs: string[],
  code: number
}
```

##### Examples

{% tabs pika-button_example %}

{% tab pika-button_example Curl %}
``` bash
curl -H "Accept: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/pika/button \
     -F "discord=<Discord token>" \
     -F "jobid=<Completed pika/… jobid>" \
     -F "button=<Button from buttons array of above jobid>" 
```
{% endtab %}

{% tab pika-button_example JavaScript %}
``` javascript
const main = async () => {
    const apiUrl = "https://api.useapi.net/v1/pika/button";
    const token = "API token";
    const jobid = "Completed pika/… jobid";
    const button = "Button from buttons array of above jobid";
    const discord = "Discord token";
    const data = {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${token}`
        }
    };
    const formData = new FormData();
    formData.append("jobid", jobid);
    formData.append("button", button);
    formData.append("discord", discord);

    data.body = formData;
    const response = await fetch(apiUrl, data);
    const result = await response.json();
    console.log("response", { response, result });
};
main()
```
{% endtab %}

{% tab pika-button_example Python %}
``` python
import requests

api_url = "https://api.useapi.net/v1/pika/button"
token = "API token"
jobid = "Completed pika/… jobid"
button = "Button from buttons array of above jobid"
discord = "Discord token"
channel = "Discord channel"

headers = {
    'Authorization': f'Bearer {token}'
}

files = {
    'jobid': (None, jobid),
    'button': (None, button),
    'discord': (None, discord)
}

response = requests.post(api_url, headers=headers, files=files)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/post-pika-create ===
Document URL: https://useapi.net/docs/api-pika-v1/post-pika-create
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-post">POST</code> pika/create
parent: Pika API v1
nav_order: 500
nav_exclude: true
---
## Pika [/create](https://pikalabsai.org/pika-labs-commands-and-parameters) command 
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

Use this endpoint to submit the Pika [/create](https://pikalabsai.org/pika-labs-commands-and-parameters) command to your [Discord Pika channel](../start-here/setup-pika). Results obtained as a callback via optional parameter [`replyUrl`](#request-body) or by querying [pika/jobs/?jobid=<code class="language-plaintext highlighter-rouge">jobid</code>](../api-pika-v1/get-pika-jobid) endpoint.  

It is **important** not to use the Pika account setup for API access for any purposes other than its intended use, such as executing `/create` or any other Pika commands _manually_ or in conjunction with _any other_ automation tools. The useapi.net API internally tracks the usage of the Pika account, including the number of currently active executions. Using it for other activities may cause API to function incorrectly.

{: .post }
> **https://api.useapi.net/v1/pika/create**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: multipart/form-data
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Request Body
```json
{
    "prompt": "Pika prompt",
    "image": "Pika image File or Blob",
    "discord": "Discord token",
    "channel": "Discord channel id",
    "maxJobs": 10,
    "replyUrl": "Place your call back URL here",
    "replyRef": "Place your reference id here"
}
```
- `prompt` is **required**, must contain Pika [/create](https://pikalabsai.org/pika-labs-commands-and-parameters) prompt.  
  Maximum length 1500 characters.  

- `image` is optional, use it to prompt the Pika Bot to begin your video with the provided image. Must be either a [File](https://developer.mozilla.org/en-US/docs/Web/API/File) or [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) object when included in this [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) POST request.

- `discord`, `channel` are optional, if not provided randomly selected available account from [pika/account](../api-pika-v1/get-pika-account) will be used. See [Setup Pika](../start-here/setup-pika) for details.    
**Note** You may specify the `channel` value alone (omitting `discord`) when you wish to use a specific account from the configured list at [pika/account](../api-pika-v1/get-pika-account).

- `maxJobs` is optional, if not provided value for `channel` account selected above will be used, if not provided defaulted to 10.  

- `replyUrl` is optional, if not provided value from [useapi.net account](../account-management/get-account) will be used.  
  Place here your callback URL. API will call the provided `replyUrl` once job completed or failed.  
  Maximum length 1024 characters.  
  We recommend using sites like [webhook.site](https://webhook.site) to test callback URL functionality.  

 - `replyRef` is optional, place here your reference id which will be stored and returned along with this job response / result.  
  Maximum length 1024 characters.  
  
##### Responses 

{% tabs post_pika-create_response %}

{% tab post_pika-create_response <span class="http-status-good">200</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>

Use returned `jobid` to [retrieve Pika job status and results](../api-pika-v1/get-pika-jobid). `content` contains message generated by Pika reflecting current generation parameters and progress.

```json
{
    "jobid": "<jobid>",
    "verb": "pika-create",
    "status": "started",
    "created": "2023-09-09T02:04:49.667Z",
    "updated": "2023-09-09T02:04:53.490Z",
    "prompt": "smiling and blinking",
    "image": { "size": 1628384, "type": "image/png" },
    "discord": "<ABC…secured…xyz>",
    "channel": "<Discord channel id>",
    "maxJobs": 10,
    "replyUrl": "https://webhook.site/abc",
    "replyRef": "<your optional reference id>",
    "messageId": "<Discord message id>",
    "content": "<@Discord user id> Creation job queued. (Prompt: smiling and blinking  Image: 1 Attachment  Author: <@Discord user id>)",
    "timestamp": "2023-09-09T02:04:51.926000+00:00",
    "code": 200
}
```
{% endtab %}

{% tab post_pika-create_response <span class="http-status-bad">400</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>

```json
{
    "error": 
      "prompt, discord or channel value is missing"
      "prompt, replyRef or replyUrl is too long"
      "image is not File or Blob"
    "code": 400
}
```
{% endtab %}


{% tab post_pika-create_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```
{% endtab %}

{% tab post_pika-create_response <span class="http-status-bad">402</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```
{% endtab %}

{% tab post_pika-create_response <span class="http-status-bad">422</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422" rel="noreferrer" target="_blank"><span class="http-status-bad">422 Unprocessable Content</span></a>

Moderated message or invalid prompt params.

```json
{
    "error": "Sorry, your input may be inconsistent with server rules.",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```

```json
{
    "error": "Invalid parameter",
    "errorDetails": "Unrecognized parameter(s): `size`",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```
{% endtab %}

{% tab post_pika-create_response <span class="http-status-bad">429</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429" rel="noreferrer" target="_blank"><span class="http-status-bad">429 Too Many Requests</span></a>

Wait in a loop for **at least** 10..30 seconds and retry again.

There are two possible cases for API response 429.

1. API query is full and can not accept new [pika/create](#pika-create-command) requests. Size of query defined by [`maxJobs` optional parameter](#request-body). Wait in a loop for **at least** 10..30 seconds and retry again.
```json
{
    "error": "Maximum of <maxJobs> jobs executing in parallel supported",
    "executingJobs": [
      "<jobid>",
      "<jobid>",
      "<jobid>"
    ],
    "code": 429
}
```
2. The API received an HTTP status 429 from the Discord API when it attempted to POST to the `/interactions` endpoint. Under normal circumstances, this should be a rare occurrence because the API is designed to strictly adhere to Discord rate limits. However, in certain scenarios, Discord may still issue a 429 response.
```json
{
    "error": "Discord /interactions failed with HTTP status 429",
    "errorDetails": "{\"global\":true,\"message\":\"You are being rate limited.\",\"retry_after\":10}",
    "code": 429
}
```
{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  jobid: string, // Use returned jobid value to retrieve job status and results
  verb: 'pika-create',
  status: 'started' | 'moderated' | 'failed',
  created: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  updated: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  prompt: string,
  image: { size: number, type: string },
  discord: string, // Provided for debugging purposes only, contains the first 3 and the last 3 characters of the original value
  channel: string,
  maxJobs: number,
  replyUrl: string,
  replyRef: string,
  messageId: string,
  content: string, // Contains message generated by Pika reflecting current generation parameters and progress
  timestamp: string,
  error: string,
  errorDetails: string,
  executingJobs: string[],
  code: number
}
```

##### Examples

{% tabs pika-create_example %}

{% tab pika-create_example Curl %}
``` bash
curl -H "Accept: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/pika/create \
     -F "discord=<Discord token>" \
     -F "channel=<Discord channel id>" \
     -F "prompt=<Pika prompt>" \
     -F 'image=@"<Path to the image>"'
```
{% endtab %}

{% tab pika-create_example JavaScript %}
``` javascript
const main = async () => {
    const apiUrl = "https://api.useapi.net/v1/pika/create";
    const token = "API token";
    const prompt = "Pika prompt";
    const discord = "Discord token";
    const channel = "Discord channel";
    const data = {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${token}`
        }
    };
    const formData = new FormData();
    formData.append("prompt", prompt);
    formData.append("discord", discord);
    formData.append("channel", channel);
    /*
        // Example 1: Fetch image from URL
        const imageUrl = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg";
        const responseImage = await fetch(imageUrl);
        formData.append("image", await responseImage.blob());
    */
    /* 
        // Example 2: Load image from local file (Blob)
        const fsp = require('fs').promises;
        const imageFileName = "./pika.webp";
        const blob = new Blob([await fsp.readFile(imageFileName)]);
        formData.append("image", blob);
    */
    /*
        // Example 3: Load from input file html element
        // <input id="pika-create-image-url" type="file"> 
        const imageFile = document.getElementById(`pika-create-image-file`);
        if (imageFile.files[0])
            formData.append("image", imageFile.files[0]);
    */
    data.body = formData;
    const response = await fetch(apiUrl, data);
    const result = await response.json();
    console.log("response", { response, result });
};
main()
```
{% endtab %}

{% tab pika-create_example Python %}
``` python
import requests

api_url = "https://api.useapi.net/v1/pika/create"
token = "API token"
prompt = "Pika prompt"
discord = "Discord token"
channel = "Discord channel"

headers = {
    'Authorization': f'Bearer {token}'
}

files = {
    'prompt': (None, prompt),
    'discord': (None, discord),
    'channel': (None, channel)
}

# # Example 1: Fetch image from URL
# image_url = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg"
# response_image = requests.get(image_url)
# image_content = response_image.content
# files['image'] = ('image.jpg', image_content, 'image/jpeg')

# # Example 2: Load image from local file
# image_file_path = "./pika.webp"
# with open(image_file_path, 'rb') as image_file:
#     files['image'] = ('pika.webp', image_file.read(), 'image/webp')

response = requests.post(api_url, headers=headers, files=files)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/post-pika-encrypt_image ===
Document URL: https://useapi.net/docs/api-pika-v1/post-pika-encrypt_image
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-post">POST</code> pika/encrypt_image
parent: Pika API v1
nav_order: 800
nav_exclude: true
---
## Pika [/encrypt_image](https://pikalabsai.org/pika-labs-commands-and-parameters) command 
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

Use this endpoint to submit the Pika [/encrypt_image](https://pikalabsai.org/pika-labs-commands-and-parameters) command to your [Discord Pika channel](../start-here/setup-pika). Results obtained as a callback via optional parameter [`replyUrl`](#request-body) or by querying [pika/jobs/?jobid=<code class="language-plaintext highlighter-rouge">jobid</code>](../api-pika-v1/get-pika-jobid) endpoint.  

It is **important** not to use the Pika account setup for API access for any purposes other than its intended use, such as executing `/encrypt_image` or any other Pika commands _manually_ or in conjunction with _any other_ automation tools. The useapi.net API internally tracks the usage of the Pika account, including the number of currently active executions. Using it for other activities may cause API to function incorrectly.

{: .post }
> **https://api.useapi.net/v1/pika/encrypt_image**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: multipart/form-data
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Request Body
```json
{
    "message": "Message image to be encrypted, must be File or Blob",
    "prompt": "Pika prompt",
    "image": "Reference image, must be File or Blob",
    "discord": "Discord token",
    "channel": "Discord channel id",
    "maxJobs": 10,
    "replyUrl": "Place your call back URL here",
    "replyRef": "Place your reference id here"
}
```
- `message` is **required**, image to be encrypted. Must be either a [File](https://developer.mozilla.org/en-US/docs/Web/API/File) or [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) object when included in this [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) POST request.

- `prompt` is **required**, must contain Pika [/encrypt_image](https://pikalabsai.org/pika-labs-commands-and-parameters) prompt.  
  Maximum length 1500 characters.  

- `image` is optional, use it as a reference image. Must be either a [File](https://developer.mozilla.org/en-US/docs/Web/API/File) or [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) object when included in this [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) POST request.

- `discord`, `channel` are optional, if not provided randomly selected available account from [pika/account](../api-pika-v1/get-pika-account) will be used. See [Setup Pika](../start-here/setup-pika) for details.    
**Note** You may specify the `channel` value alone (omitting `discord`) when you wish to use a specific account from the configured list at [pika/account](../api-pika-v1/get-pika-account).

- `maxJobs` is optional, if not provided value for `channel` account selected above will be used, if not provided defaulted to 10.  

- `replyUrl` is optional, if not provided value from [useapi.net account](../account-management/get-account) will be used.  
  Place here your callback URL. API will call the provided `replyUrl` once job completed or failed.  
  Maximum length 1024 characters.  
  We recommend using sites like [webhook.site](https://webhook.site) to test callback URL functionality.  

 - `replyRef` is optional, place here your reference id which will be stored and returned along with this job response / result.  
  Maximum length 1024 characters.  
  
##### Responses 

{% tabs post_pika-encrypt_image_response %}

{% tab post_pika-encrypt_image_response <span class="http-status-good">200</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>

Use returned `jobid` to [retrieve Pika job status and results](../api-pika-v1/get-pika-jobid). `content` contains message generated by Pika reflecting current generation parameters and progress.

```json
{
    "jobid": "<jobid>",
    "verb": "pika-encrypt_image",
    "status": "started",
    "created": "2023-09-09T02:04:49.667Z",
    "updated": "2023-09-09T02:04:53.490Z",
    "message": { "size": 92729, "type": "image/jpeg" },    
    "prompt": "waves crashing over the sandy beach, overhead shot -w 2 -size 100",
    "image": { "size": 23558, "type": "image/webp" },
    "discord": "<ABC…secured…xyz>",
    "channel": "<Discord channel id>",
    "maxJobs": 10,
    "replyUrl": "https://webhook.site/abc",
    "replyRef": "<your optional reference id>",
    "messageId": "<Discord message id>",
    "content": "<@Discord user id>  Creation job queued. (Prompt: waves crashing over the sandy beach, overhead shot -w 2 -size 100  Message: 1 Attachment  Image: 1 Attachment  Author: <@Discord user id>)",
    "timestamp": "2023-09-09T02:04:51.926000+00:00",
    "code": 200
}
```
{% endtab %}

{% tab post_pika-encrypt_image_response <span class="http-status-bad">400</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>

```json
{
    "error": 
      "message, prompt, discord or channel value is missing"
      "prompt, replyRef or replyUrl is too long"
      "message is not File or Blob"
      "image is not File or Blob"
    "code": 400
}
```
{% endtab %}


{% tab post_pika-encrypt_image_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```
{% endtab %}

{% tab post_pika-encrypt_image_response <span class="http-status-bad">402</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```
{% endtab %}

{% tab post_pika-encrypt_image_response <span class="http-status-bad">422</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422" rel="noreferrer" target="_blank"><span class="http-status-bad">422 Unprocessable Content</span></a>

Moderated message or invalid prompt params.

```json
{
    "error": "Sorry, your input may be inconsistent with server rules.",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```

```json
{
    "error": "Invalid parameter",
    "errorDetails": "Unrecognized parameter(s): `size`",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```
{% endtab %}

{% tab post_pika-encrypt_image_response <span class="http-status-bad">429</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429" rel="noreferrer" target="_blank"><span class="http-status-bad">429 Too Many Requests</span></a>

Wait in a loop for **at least** 10..30 seconds and retry again.

There are two possible cases for API response 429.

1. API query is full and can not accept new [pika/encrypt_image](#pika-encrypt_image-command) requests. Size of query defined by [`maxJobs` optional parameter](#request-body). Wait in a loop for **at least** 10..30 seconds and retry again.
```json
{
    "error": "Maximum of <maxJobs> jobs executing in parallel supported",
    "executingJobs": [
      "<jobid>",
      "<jobid>",
      "<jobid>"
    ],
    "code": 429
}
```
2. The API received an HTTP status 429 from the Discord API when it attempted to POST to the `/interactions` endpoint. Under normal circumstances, this should be a rare occurrence because the API is designed to strictly adhere to Discord rate limits. However, in certain scenarios, Discord may still issue a 429 response.
```json
{
    "error": "Discord /interactions failed with HTTP status 429",
    "errorDetails": "{\"global\":true,\"message\":\"You are being rate limited.\",\"retry_after\":10}",
    "code": 429
}
```
{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  jobid: string, // Use returned jobid value to retrieve job status and results
  verb: 'pika-encrypt_image',
  status: 'started' | 'moderated' | 'failed',
  created: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  updated: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  message: { size: number, type: string },
  prompt: string,
  image: { size: number, type: string },
  discord: string, // Provided for debugging purposes only, contains the first 3 and the last 3 characters of the original value
  channel: string,
  maxJobs: number,
  replyUrl: string,
  replyRef: string,
  messageId: string,
  content: string, // Contains message generated by Pika reflecting current generation parameters and progress
  timestamp: string,
  error: string,
  errorDetails: string,
  executingJobs: string[],
  code: number
}
```

##### Examples

{% tabs pika-encrypt_image_example %}

{% tab pika-encrypt_image_example Curl %}
``` bash
curl -H "Accept: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/pika/encrypt_image \
     -F "discord=<Discord token>" \
     -F "channel=<Discord channel id>" \
     -F 'message=@"<Path to the message image>"' \
     -F "prompt=<Pika prompt>" \
     -F 'image=@"<Path to the reference image>"' 
```
{% endtab %}

{% tab pika-encrypt_image_example JavaScript %}
``` javascript
const main = async () => {
    const apiUrl = "https://api.useapi.net/v1/pika/encrypt_image";
    const token = "API token";
    const prompt = "Pika prompt";
    const discord = "Discord token";
    const channel = "Discord channel";
    const data = {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${token}`
        }
    };
    const formData = new FormData();
    formData.append("prompt", prompt);
    formData.append("discord", discord);
    formData.append("channel", channel);
    /*
        // Example 1: Fetch image from URL
        const imageUrl = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg";
        const responseImage = await fetch(imageUrl);
        formData.append("message", await responseImage.blob());
    */
    /* 
        // Example 2: Load image from local file (Blob)
        const fsp = require('fs').promises;
        const imageFileName = "./pika.webp";
        const blob = new Blob([await fsp.readFile(imageFileName)]);
        formData.append("message", blob);
    */
    /*
        // Example 3: Load from input file html element
        // <input id="pika-encrypt_image-image-url" type="file"> 
        const imageFile = document.getElementById(`pika-encrypt_image-image-file`);
        if (imageFile.files[0])
            formData.append("message", imageFile.files[0]);
    */
    data.body = formData;
    const response = await fetch(apiUrl, data);
    const result = await response.json();
    console.log("response", { response, result });
};
main()
```
{% endtab %}

{% tab pika-encrypt_image_example Python %}
``` python
import requests

api_url = "https://api.useapi.net/v1/pika/encrypt_image"
token = "API token"
prompt = "Pika prompt"
discord = "Discord token"
channel = "Discord channel"

headers = {
    'Authorization': f'Bearer {token}'
}

files = {
    'prompt': (None, prompt),
    'discord': (None, discord),
    'channel': (None, channel)
}

# # Example 1: Fetch image from URL
# image_url = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg"
# response_image = requests.get(image_url)
# image_content = response_image.content
# files['message'] = ('image.jpg', image_content, 'image/jpeg')

# # Example 2: Load image from local file
# image_file_path = "./pika.webp"
# with open(image_file_path, 'rb') as image_file:
#     files['message'] = ('pika.webp', image_file.read(), 'image/webp')

response = requests.post(api_url, headers=headers, files=files)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/post-pika-encrypt_text ===
Document URL: https://useapi.net/docs/api-pika-v1/post-pika-encrypt_text
---
layout: default
title: <code class="language-plaintext highlighter-rouge background-method-post">POST</code> pika/encrypt_text
parent: Pika API v1
nav_order: 700
nav_exclude: true
---
## Pika [/encrypt_text](https://pikalabsai.org/pika-labs-commands-and-parameters) command 
{: .no_toc }

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

Use this endpoint to submit the Pika [/encrypt_text](https://pikalabsai.org/pika-labs-commands-and-parameters) command to your [Discord Pika channel](../start-here/setup-pika). Results obtained as a callback via optional parameter [`replyUrl`](#request-body) or by querying [pika/jobs/?jobid=<code class="language-plaintext highlighter-rouge">jobid</code>](../api-pika-v1/get-pika-jobid) endpoint.  

It is **important** not to use the Pika account setup for API access for any purposes other than its intended use, such as executing `/encrypt_text` or any other Pika commands _manually_ or in conjunction with _any other_ automation tools. The useapi.net API internally tracks the usage of the Pika account, including the number of currently active executions. Using it for other activities may cause API to function incorrectly.

{: .post }
> **https://api.useapi.net/v1/pika/encrypt_text**

##### Request Headers
``` yaml
Authorization: Bearer {API token}
Content-Type: multipart/form-data
```
- `API token` is **required**, see [Setup useapi.net](../start-here/setup-useapi) for details.   

##### Request Body
```json
{
    "message": "Message text to encrypt",
    "prompt": "Pika prompt",
    "font": "Font of the text",
    "image": "Reference image, must be File or Blob",
    "discord": "Discord token",
    "channel": "Discord channel id",
    "maxJobs": 10,
    "replyUrl": "Place your call back URL here",
    "replyRef": "Place your reference id here"
}
```
- `message` is **required**, text message to be encrypted.  
  Maximum length 20 characters.  

- `prompt` is **required**, must contain Pika [/encrypt_text](https://pikalabsai.org/pika-labs-commands-and-parameters) prompt.  
  Maximum length 1500 characters.  

- `font` is optional, must one of following values: `MODERN`, `COMICS`, `SANS SERIF`, `BAUHAUS` or `RETRO`.  

- `image` is optional, use it as a reference image. Must be either a [File](https://developer.mozilla.org/en-US/docs/Web/API/File) or [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) object when included in this [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) POST request.

- `discord`, `channel` are optional, if not provided randomly selected available account from [pika/account](../api-pika-v1/get-pika-account) will be used. See [Setup Pika](../start-here/setup-pika) for details.    
**Note** You may specify the `channel` value alone (omitting `discord`) when you wish to use a specific account from the configured list at [pika/account](../api-pika-v1/get-pika-account).

- `maxJobs` is optional, if not provided value for `channel` account selected above will be used, if not provided defaulted to 10.  

- `replyUrl` is optional, if not provided value from [useapi.net account](../account-management/get-account) will be used.  
  Place here your callback URL. API will call the provided `replyUrl` once job completed or failed.  
  Maximum length 1024 characters.  
  We recommend using sites like [webhook.site](https://webhook.site) to test callback URL functionality.  

 - `replyRef` is optional, place here your reference id which will be stored and returned along with this job response / result.  
  Maximum length 1024 characters.  
  
##### Responses 

{% tabs post_pika-encrypt_text_response %}

{% tab post_pika-encrypt_text_response <span class="http-status-good">200</span> %}

<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200" rel="noreferrer" target="_blank"><span class="http-status-good">200 OK</span></a>

Use returned `jobid` to [retrieve Pika job status and results](../api-pika-v1/get-pika-jobid). `content` contains message generated by Pika reflecting current generation parameters and progress.

```json
{
    "jobid": "<jobid>",
    "verb": "pika-encrypt_text",
    "status": "started",
    "created": "2023-09-09T02:04:49.667Z",
    "updated": "2023-09-09T02:04:53.490Z",
    "message": "HELLO THERE",
    "prompt": "waves crashing over the sandy beach, overhead shot -w 2 -size 100",
    "image": { "size": 334372, "type": "image/jpeg" },
    "font": "SANS SERIF",    
    "discord": "<ABC…secured…xyz>",
    "channel": "<Discord channel id>",
    "maxJobs": 10,
    "replyUrl": "https://webhook.site/abc",
    "replyRef": "<your optional reference id>",
    "messageId": "<Discord message id>",
    "content": "<@Discord user id> Creation job queued. (Prompt: waves crashing over the sandy beach, overhead shot -w 2 -size 100  Message: HELLO THERE (Font: SANS SERIF)  Image: 1 Attachment  Author: <@Discord user id>)",
    "timestamp": "2023-09-09T02:04:51.926000+00:00",
    "code": 200
}
```
{% endtab %}

{% tab post_pika-encrypt_text_response <span class="http-status-bad">400</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400" rel="noreferrer" target="_blank"><span class="http-status-bad">400 Bad Request</span></a>

```json
{
    "error": 
      "message, prompt, discord or channel value is missing"
      "message, prompt, replyRef or replyUrl is too long"
      "font <font> is not one of allowed values <allowed font values>"
      "image is not File or Blob"
    "code": 400
}
```
{% endtab %}


{% tab post_pika-encrypt_text_response <span class="http-status-bad">401</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401" rel="noreferrer" target="_blank"><span class="http-status-bad">401 Unauthorized</span></a>

```json
{
    "error": "Unauthorized",
    "code": 401
}
```
{% endtab %}

{% tab post_pika-encrypt_text_response <span class="http-status-bad">402</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402" rel="noreferrer" target="_blank"><span class="http-status-bad">402 Payment Required</span></a>

```json
{
    "error": "Account has no subscription or subscription expired",
    "code": 402
}
```
{% endtab %}

{% tab post_pika-encrypt_text_response <span class="http-status-bad">422</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422" rel="noreferrer" target="_blank"><span class="http-status-bad">422 Unprocessable Content</span></a>

Moderated message or invalid prompt params.

```json
{
    "error": "Sorry, your input may be inconsistent with server rules.",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```

```json
{
    "error": "Invalid parameter",
    "errorDetails": "Unrecognized parameter(s): `size`",
    "jobid": "<jobid>",
    "status": "moderated",
    "code": 422
}
```
{% endtab %}

{% tab post_pika-encrypt_text_response <span class="http-status-bad">429</span> %}
<a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429" rel="noreferrer" target="_blank"><span class="http-status-bad">429 Too Many Requests</span></a>

Wait in a loop for **at least** 10..30 seconds and retry again.

There are two possible cases for API response 429.

1. API query is full and can not accept new [pika/encrypt_text](#pika-encrypt_text-command) requests. Size of query defined by [`maxJobs` optional parameter](#request-body). Wait in a loop for **at least** 10..30 seconds and retry again.
```json
{
    "error": "Maximum of <maxJobs> jobs executing in parallel supported",
    "executingJobs": [
      "<jobid>",
      "<jobid>",
      "<jobid>"
    ],
    "code": 429
}
```
2. The API received an HTTP status 429 from the Discord API when it attempted to POST to the `/interactions` endpoint. Under normal circumstances, this should be a rare occurrence because the API is designed to strictly adhere to Discord rate limits. However, in certain scenarios, Discord may still issue a 429 response.
```json
{
    "error": "Discord /interactions failed with HTTP status 429",
    "errorDetails": "{\"global\":true,\"message\":\"You are being rate limited.\",\"retry_after\":10}",
    "code": 429
}
```
{% endtab %}

{% endtabs %}

##### Model 
```typescript
{ // TypeScript, all fields are optional
  jobid: string, // Use returned jobid value to retrieve job status and results
  verb: 'pika-encrypt_text',
  status: 'started' | 'moderated' | 'failed',
  created: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  updated: string, // YYYY-MM-DDTHH:mm:ss.sssZ, IS0 8601, UTC
  message: string,
  prompt: string,
  font: string,
  image: { size: number, type: string },
  discord: string, // Provided for debugging purposes only, contains the first 3 and the last 3 characters of the original value
  channel: string,
  maxJobs: number,
  replyUrl: string,
  replyRef: string,
  messageId: string,
  content: string, // Contains message generated by Pika reflecting current generation parameters and progress
  timestamp: string,
  error: string,
  errorDetails: string,
  executingJobs: string[],
  code: number
}
```

##### Examples

{% tabs pika-encrypt_text_example %}

{% tab pika-encrypt_text_example Curl %}
``` bash
curl -H "Accept: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/pika/encrypt_text \
     -F "discord=<Discord token>" \
     -F "channel=<Discord channel id>" \
     -F "message=<Pika message>" \
     -F "prompt=<Pika prompt>" \
     -F "font=<Pika font>" \
     -F 'image=@"<Path to the image>"' 
```
{% endtab %}

{% tab pika-encrypt_text_example JavaScript %}
``` javascript
const main = async () => {
    const apiUrl = "https://api.useapi.net/v1/pika/encrypt_text";
    const token = "API token";
    const message = "Pika message";
    const prompt = "Pika prompt";
    const font = "Pika font";
    const discord = "Discord token";
    const channel = "Discord channel";
    const data = {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${token}`
        }
    };
    const formData = new FormData();
    formData.append("message", message);
    formData.append("prompt", prompt);
    formData.append("font", font);
    formData.append("discord", discord);
    formData.append("channel", channel);
    /*
        // Example 1: Fetch image from URL
        const imageUrl = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg";
        const responseImage = await fetch(imageUrl);
        formData.append("image", await responseImage.blob());
    */
    /* 
        // Example 2: Load image from local file (Blob)
        const fsp = require('fs').promises;
        const imageFileName = "./pika.webp";
        const blob = new Blob([await fsp.readFile(imageFileName)]);
        formData.append("image", blob);
    */
    /*
        // Example 3: Load from input file html element
        // <input id="pika-encrypt_text-image-url" type="file"> 
        const imageFile = document.getElementById(`pika-encrypt_text-image-file`);
        if (imageFile.files[0])
            formData.append("image", imageFile.files[0]);
    */
    data.body = formData;
    const response = await fetch(apiUrl, data);
    const result = await response.json();
    console.log("response", { response, result });
};
main()
```
{% endtab %}

{% tab pika-encrypt_text_example Python %}
``` python
import requests

api_url = "https://api.useapi.net/v1/pika/encrypt_text"
token = "API token"
message = "Pika message"
prompt = "Pika prompt"
font = "Pika font"
discord = "Discord token"
channel = "Discord channel"

headers = {
    'Authorization': f'Bearer {token}'
}

files = {
    'message': (None, message),
    'prompt': (None, prompt),
    'font': (None, font),
    'discord': (None, discord),
    'channel': (None, channel)
}

# # Example 1: Fetch image from URL
# image_url = "https://upload.wikimedia.org/wikipedia/commons/7/7d/Mona_Lisa_color_restoration.jpg"
# response_image = requests.get(image_url)
# image_content = response_image.content
# files['image'] = ('image.jpg', image_content, 'image/jpeg')

# # Example 2: Load image from local file
# image_file_path = "./pika.webp"
# with open(image_file_path, 'rb') as image_file:
#     files['image'] = ('pika.webp', image_file.read(), 'image/webp')

response = requests.post(api_url, headers=headers, files=files)
print(response, response.json())
```
{% endtab %}

{% endtabs %}


=== URL: https://useapi.net/docs/api-pika-v1/setup-multiple-pika-accounts ===
Document URL: https://useapi.net/docs/api-pika-v1/setup-multiple-pika-accounts
---
layout: default
title: ⚙️ Setup multiple accounts
parent: Pika API v1
nav_order: 5000
nav_exclude: true
---

<span class="required-input-field"><b>Pika Discord bot API has been decommissioned and no longer available.</b></span>

## How to use multiple Pika accounts 
{: .no_toc }

For your convenience, you can save your Pika account(s) configuration, eliminating the need to provide them with every API call. Simply POST your account(s) configuration using the [pika/account/`channel`](../api-pika-v1/post-pika-account-channel) endpoint. 

You may configure as many Discord/Pika accounts as desired. If more than one account is configured under [pika/account](../api-pika-v1/get-pika-account), the API will retrieve a list of available accounts, determine which have the capacity to execute the job, and randomly select an available account, thereby effectively acting as a load balancer.

To take advantage of saved configurations and account load balancing, please follow these simple steps:
- Gather your Pika account(s) information as outlined at [Setup Pika](../start-here/setup-pika).
- Post your configuration(s) using the [pika/account/`channel`](../api-pika-v1/post-pika-account-channel) endpoint.
- You can then start making API calls without specifying the `discord` and `channel` values for every call.

To see all your currently configured Pika accounts, please use the [pika/account](../api-pika-v1/get-pika-account) endpoint.

##### Wait there's more…

What if you want to use multiple Pika accounts but prefer to implement your own tracking and load balancing logic? Good news – that's still possible! Just continue to provide the `discord`, `channel`, and `maxJobs` values with each call, and our API will take care of the rest, ensuring proper operation. This is possible  our API tracks job executions under the same  `channel`. The downside of this approach is that it now becomes your responsibility to determine which account (`channel`) should be used for the next call. However, we suppose this might be precisely what you want in certain situations, so we've kept this option available.

Feel free to [reach out to us](../support) if you have any questions or concerns.


=== URL: https://useapi.net/docs/questions-and-answers ===
Document URL: https://useapi.net/docs/questions-and-answers
---
title: Q&A
nav_order: 110000
layout: home
---

# Questions and Answers
{: .no_toc }

<small>4 min read • September 2023 (January 14, 2026)</small>

## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

---

### How to avoid Midjourney bans?  

Using automation is against Discord and Midjourney's Terms of Service, so you need to plan accordingly and have backup account(s) ready. 

* The best practice is to create several new Discord accounts and join the Midjourney Discord server. These accounts should be used exclusively for API work and nothing else. We strongly recommend using a VPN to prevent your personal data/IP addresses from being leaked. You can use the [Opera](https://www.opera.com/download) browser with built-in VPN or the [Brave](https://brave.com/download) browser with [Tor support](https://support.brave.com/hc/en-us/articles/360018121491-What-is-a-Private-Window-with-Tor-Connectivity).

* Brand new/fresh Discord accounts have a significantly higher chance of being banned when running high Midjourney generation loads. Consider purchasing aged Discord accounts (2-3 years old) from marketplaces like [z2u.com](https://www.z2u.com/) for around $1-3 each. Aged accounts appear more legitimate and are less likely to trigger automated bans.

* When creating accounts in bulk, make sure to restart Opera/Brave so that your IP is different every time, since Discord tracks and records the IP addresses used to create new accounts. Make sure to log in to the Discord accounts designated for API use through a VPN. When creating new email and Discord accounts, use names closely resembling real names - something that does not look suspicious.

* Once a Discord account is created, join the Midjourney Discord [server](https://discord.com/invite/midjourney) and follow the [instructions](https://useapi.net/docs/start-here/setup-midjourney) to create your own server and invite the Midjourney bot. If you're planning to use this account, you can proceed with a Midjourney subscription. It's a good idea to create several Discord accounts with the Midjourney setup, as described above early on, this will *"age"* them and make them less suspicious later on when you need to subscribe to Midjourney.

* When paying for a Midjourney subscription use a virtual credit card number (provided by most major credit card companies) or services like [Privacy.com](https://privacy.com). Make sure to use a credit card name and address that resemble an actual address and name. Use a *different name and address* for every new Midjourney subscription. Midjourney has access to all payment details and will cross-check banned accounts' payment information to ban newly created accounts if a match is found.

* If your account gets banned, file a charge dispute with your credit card company. Since Midjourney cannot produce any evidence of you violating the ToS, the bank will fully refund your payment. Our customers have reported a 100% success rate of getting their money back, though it may take some time.

* When using the API, try to simulate real users. Avoid running generations 24/7 by establishing quiet hours (for example, you can use two or three accounts and rotate them every 12/8 hours). Midjourney seems to specifically target accounts with a large number of `--relax` usage, so try to limit those generations to a reasonable number (<300 generations/day). If you heavily rely on `--relax`, execute at least one fast generation for every NN relax generations. 
  
* Do not post public links to Discord/Midjourney CDN attachments, they contain your Discord account number and can be used to trace back to your account.

* Sharing cross-account `--p` codes is not safe. You risk all accounts using the same `--p` codes being banned by Midjourney.

* Do not run multiple requests with the same or similar prompts (e.g., "My test prompt 1", "My test prompt 2", and so on). Midjourney analyzes prompts and will force your Discord account token to expire when this kind of situation is detected. You will have to reset your Discord password manually before you can continue operating.

* Adjust [maxJobs](../docs/api-v2/post-account-midjourney) parameter to be one less than the maximum possible. For example, for the [Pro Plan](https://docs.midjourney.com/docs/plans) with a maximum of 12 concurrent jobs, set `maxJobs` to 11 or even 10.

* If you ever receive a [504](../docs/api-v2/post-jobs-imagine#responses) response code, it means your `maxJobs` is set to a value higher than your account plan supports. Adjust it accordingly.

* Finally, monitor for [596](../docs/api-v2/post-jobs-imagine#responses) response codes and ensure you check your API email. The API will proactively warn you if you have pending moderation messages or if Midjourney issues a CAPTCHA request.

### How to avoid Runway account suspension?

Using automation is against Runway's Terms of Service, so you need to plan accordingly and have backup account(s) ready.

* The best practice is to create several stand-by Runway accounts. These accounts should be used exclusively for API work and nothing else. We strongly recommend using a VPN to prevent your personal data/IP addresses from being leaked. You can use the [Opera](https://www.opera.com/download) browser with a built-in VPN or the [Brave](https://brave.com/download) browser with [Tor support](https://support.brave.com/hc/en-us/articles/360018121491-What-is-a-Private-Window-with-Tor-Connectivity).

* When creating accounts in bulk, make sure to restart Opera/Brave so that your IP is different every time. When creating new emails and Runway accounts, use names that closely resemble real names—something that does not look suspicious.

* Once a new Runway account is created, you will have a few free credits with which you can test the API. After testing, log out and leave the account alone until you are ready to activate the [Unlimited plan](https://runwayml.com/pricing) (the only subscription plan that makes sense to pay for).

* When paying for a Runway subscription, use a virtual credit card number (provided by most major credit card companies) or services like [Privacy.com](https://privacy.com). Make sure to use a credit card name and address that resemble an actual name and address. Use a *different name and address* for every new Runway subscription. Runway has access to all payment details and can cross-check banned accounts' payment information to ban newly created accounts if a match is found.

* If your account gets suspended, file a charge dispute with your credit card company. Since Runway cannot produce any evidence of you violating the ToS, the bank will fully refund your payment. Our customers have reported a 100% success rate of getting their money back, though it may take some time.

* When using the API, try to simulate real users. Avoid running generations 24/7 by establishing quiet hours (for example, you can use two or three accounts and rotate them every 12 to 8 hours). Avoid calling API endpoints too frequently, and consider using the `replyUrl` webhook to retrieve results, as this will ensure the least intrusive operation.

* Finally, monitor your API email—the one you used to subscribe to useapi.net services. The API will proactively warn you if your Runway account has any issues.

### Do you validate a user's text/image prompts to ensure they are passing AI services' safety requirements?

It is common practice for AI services to ban users for violating prompt guidelines (for example, see Midjourney PG13 [requirements](https://docs.midjourney.com/docs/community-guidelines)). Our API does not perform any prompt pre-validations, it will return a [422](../docs/api-v2/post-jobs-imagine#responses) status code if the job is moderated by Midjourney, and similar checks apply for the other AI APIs we offer.

Generally speaking, if you're planning to use the API for a public Telegram bot (which is one of the popular use cases) or in similar scenarios where you do not control the quality of the prompt, it might be a good idea to use a combination of a ban/stop word list along with [OpenAI ChatGPT](https://openai.com/api/pricing) or [Google Gemini](https://ai.google.dev/pricing) to check if the prompts meet safety requirements. [Gemini](https://ai.google.dev/pricing) offers a free tier with some RPM (requests per minute) limitations.

We also offer LLM models, specifically `MiniMax-Text-01`, a fast instructional multimodal model that is free to use and can validate both text and images for safety. Please see [POST minimax/llm](../docs/api-minimax-v1/post-minimax-llm).

### How is your experimental Runway API different from the official Runway API?

Official [Runway API](https://docs.dev.runwayml.com) currently only supports Gen-3 Alpha Turbo. The cost for Gen-3 Alpha Turbo 10-second generation is [$0.50](https://docs.dev.runwayml.com/usage/billing).

Our [experimental Runway API](https://useapi.net/docs/api-runwayml-v1) is a reverse-engineered version of [runwayml.com](https://runwayml.com). It fully supports **all** features of Gen-3 Alpha, Gen-3 Alpha Turbo, Act-One, Video to Video, Super-Slow Motion, Gen-2, the LipSync feature, and [more](https://useapi.net/docs/api-runwayml-v1). When used along with the Runway [Unlimited plan](https://runwayml.com/pricing), it allows you to run several hundred generations each day.

On average, you can expect the following numbers for Gen-3 Alpha Turbo 10-second generation:
- 1 generation is completed within 25 seconds
- 10 generations take about 4 minutes to complete
- 30 generations take about 12 minutes to complete
- 150 generations take about one hour to complete
    
If you generate 200+ videos, the official API will cost you $0.50 per generation, so 200 generations cost about $100. This means the $95 [Unlimited plan](https://runwayml.com/pricing), combined with our $15/month subscription, will pay for itself by the **first day**, most often within the first few hours.

We provide an API for all the features available at [runwayml.com](https://runwayml.com), including Gen-3 Alpha, Act-One, video-to-video (with extend and expand), Frames, and many more. The official Runway API only supports [Gen-3 Alpha Turbo](https://docs.dev.runwayml.com/).

### How is your experimental MiniMax API different from the official MiniMax API?

Official [MiniMax API](https://intl.minimaxi.com/document/video_generation) costs $0.43…$0.65 [link](https://www.minimaxi.com/en/price) per single 6-second-long generation.

Our [experimental MiniMax API](https://useapi.net/docs/api-minimax-v1) is a reverse-engineered version of the MiniMax/HailuoAI websites. It does not cost you anything to generate as many videos as you wish, thanks to a flat monthly [subscription](https://useapi.net/docs/subscription) fee. You can link as many [paid](https://hailuoai.video/subscribe) or free MiniMax/HailuoAI accounts to our API as you wish.

With [Unlimited](https://hailuoai.video/subscribe) Hailuo AI plan or [Standard](https://hailuoai.video/subscribe) plan for first day, you can expect the following numbers:
- 1 generation completed within 2 minutes
- 10 generations take about 20 minutes to complete
- 30 generations take about an hour to complete

If you generate 250+ videos, the official API will cost you $0.43 per generation, so 250 generations total about $107.50. This means the $95 [Unlimited](https://hailuoai.video/subscribe) plan, combined with our $15/month subscription, will pay for itself by the **first day**.

When using free [hailuoai.video](https://hailuoai.video) account, it costs one credit to generate a single image, and you can generate up to four images at once. With a daily free top-up of 100 credits, a free hailuoai.video account can generate 100 images per day – up to 3K images per month.

### Do you support [n8n](https://n8n.io) workflow automation?

Please consider the [n8n-nodes-useapi](https://github.com/lvalics/n8n-nodes-useapi) package by [lvalics](https://github.com/lvalics).

### How POST raw content to [runwayml/assets](https://useapi.net/docs/api-runwayml-v1/post-runwayml-assets) and [minimax/files](https://useapi.net/docs/api-minimax-v1/post-minimax-files) using Make.com and similar nocode tools?

We recommend using module called [0codekit](https://www.make.com/en/integrations/onesaas) to run JavaScript and return a result. 

<details markdown="block">

<summary><small>0codekit JavaScript example</small></summary>

```js
async function fetchFromURLandPOST(imageURL, name) {
  const apiToken = "<Your useapi.net API key>"; // https://useapi.net/docs/start-here/setup-useapi
  // Runway https://useapi.net/docs/api-runwayml-v1/post-runwayml-assets
  const apiUrl = `https://api.useapi.net/v1/runwayml/assets/?name=${name}`;
  // MiniMax https://useapi.net/docs/api-minimax-v1/post-minimax-files
  // const apiUrl = `https://api.useapi.net/v1/minimax/files/`;

  try {
    // Fetch the image from the URL
    const responseImage = await fetch(imageURL);

    if (!responseImage.ok) 
      throw new Error(`Failed to fetch ${imageURL}: ${responseImage.statusText}`);

    // Convert the response to a Blob
    const blob = await responseImage.blob();

    // Prepare headers for the POST request
    const headers = {
      "Authorization": `Bearer ${apiToken}`, 
      "Content-Type": blob.type,
    };

    // Make the POST request with the blob as the body
    const response = await fetch(apiUrl, {
      method: "POST",
      headers: headers,
      body: blob,
    });

    const result = await response.json();
    return { data: result };
  } catch (error) {
    return { error: error.message };
  }
}

// Calling the function
result = await fetchFromURLandPOST("https:\\website.com\image.jpeg", "my_image");
```

</details>