Doppl API Docs

curl -X POST https://doppl.polsia.app/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"name": "My App"}'

import requests

response = requests.post(
    "https://doppl.polsia.app/api/v1/keys",
    json={"name": "My App"},
)
data = response.json()
api_key = data["api_key"]
print(api_key)  # dppl_...

const res = await fetch("https://doppl.polsia.app/api/v1/keys", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ name: "My App" }),
});
const data = await res.json();
const apiKey = data.api_key;
console.log(apiKey); // dppl_...

curl -X POST https://doppl.polsia.app/api/v1/avatars \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dppl_YOUR_KEY_HERE" \
  -d '{"photo": "https://example.com/selfie.jpg", "style": "stylized"}'

# On success, the response JSON contains "avatar_url"

import requests

api_key = "dppl_YOUR_KEY_HERE"

response = requests.post(
    "https://doppl.polsia.app/api/v1/avatars",
    headers={"X-API-Key": api_key},
    json={
        "photo": "https://example.com/selfie.jpg",
        "style": "stylized",
    },
)

if response.status_code == 200:
    data = response.json()
    avatar_url = data["avatar_url"]
    print("Avatar:", avatar_url)
else:
    error = response.json()
    print("Error:", error["error"], "-", error["message"])

const apiKey = "dppl_YOUR_KEY_HERE";

const res = await fetch("https://doppl.polsia.app/api/v1/avatars", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": apiKey,
  },
  body: JSON.stringify({
    photo: "https://example.com/selfie.jpg",
    style: "stylized",
  }),
});

if (!res.ok) {
  const error = await res.json();
  throw new Error(`${error.error}: ${error.message}`);
}

const data = await res.json();
console.log("Avatar:", data.avatar_url);

# Redirect user to Doppl authorization endpoint
curl -X GET "https://doppl.polsia.app/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=https://yourapp.com/callback&response_type=code&scope=avatars:read avatars:write"

curl -X POST https://doppl.polsia.app/oauth/token \n  # Replace CODE with the authorization code from the redirect
  -H "Content-Type: application/json" \n  -d ‘{
    "grant_type": "authorization_code",
    "code": "AUTHORIZATION_CODE",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uri": "https://yourapp.com/callback"
  ‘}

curl -X POST https://doppl.polsia.app/api/v1/avatars \n  -H "Authorization: Bearer ACCESS_TOKEN"
  -H "Content-Type: application/json" \n  -d ‘{"photo": "https://example.com/photo.jpg", "style": "stylized"}‘

# Redirect user to Doppl authorization endpoint
import requests

auth_url = "https://doppl.polsia.app/oauth/authorize"
params = {
    "client_id": "YOUR_CLIENT_ID",
    "redirect_uri": "https://yourapp.com/callback",
    "response_type": "code",
    "scope": "avatars:read avatars:write",
}
# Build the URL and redirect the user
print(f"{auth_url}?{"&".join(f"{k}={v}" for k, v in params.items())}")

import requests

response = requests.post(
    "https://doppl.polsia.app/oauth/token",
    json={
        "grant_type": "authorization_code",
        "code": "AUTHORIZATION_CODE",
        "client_id": "YOUR_CLIENT_ID",
        "client_secret": "YOUR_CLIENT_SECRET",
        "redirect_uri": "https://yourapp.com/callback",
    },
)
tokens = response.json()
access_token = tokens["access_token"]
refresh_token = tokens["refresh_token"]

import requests

response = requests.post(
    "https://doppl.polsia.app/api/v1/avatars",
    headers={"Authorization": f"Bearer {access_token}"},
    json={"photo": "https://example.com/photo.jpg", "style": "stylized"},
)

// Redirect user to Doppl authorization endpoint
const authUrl = "https://doppl.polsia.app/oauth/authorize";
const params = new URLSearchParams({
  client_id: "YOUR_CLIENT_ID",
  redirect_uri: "https://yourapp.com/callback",
  response_type: "code",
  scope: "avatars:read avatars:write",
});
console.log(`${authUrl}?${params}`);
// Redirect the user in your app

const res = await fetch("https://doppl.polsia.app/oauth/token", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    grant_type: "authorization_code",
    code: "AUTHORIZATION_CODE",
    client_id: "YOUR_CLIENT_ID",
    client_secret: "YOUR_CLIENT_SECRET",
    redirect_uri: "https://yourapp.com/callback",
  }),
});
const tokens = await res.json();
const accessToken = tokens.access_token;
const refreshToken = tokens.refresh_token;

const res = await fetch("https://doppl.polsia.app/api/v1/avatars", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ photo: "https://example.com/photo.jpg", style: "stylized" }),
});

curl -X POST https://doppl.polsia.app/oauth/token \n  -H "Content-Type: application/json"
  -d '{
    "grant_type": "refresh_token",
    "refresh_token": "YOUR_REFRESH_TOKEN",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

import requests

response = requests.post(
    "https://doppl.polsia.app/oauth/token",
    json={
        "grant_type": "refresh_token",
        "refresh_token": "YOUR_REFRESH_TOKEN",
        "client_id": "YOUR_CLIENT_ID",
        "client_secret": "YOUR_CLIENT_SECRET",
    },
)
tokens = response.json()
new_access_token = tokens["access_token"]
# The response may include a new refresh_token; store it for next time
new_refresh_token = tokens.get("refresh_token", "YOUR_REFRESH_TOKEN")

const res = await fetch("https://doppl.polsia.app/oauth/token", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    grant_type: "refresh_token",
    refresh_token: "YOUR_REFRESH_TOKEN",
    client_id: "YOUR_CLIENT_ID",
    client_secret: "YOUR_CLIENT_SECRET",
  }),
});
const tokens = await res.json();
const newAccessToken = tokens.access_token;
// Store new refresh_token for next refresh cycle
const newRefreshToken = tokens.refresh_token || refreshToken;

# Forward a sample Doppl payload to your local handler
curl -X POST http://localhost:3000/webhooks/doppl \
  -H "Content-Type: application/json" \
  -H "X-Doppl-Signature: sha256=<computed-hex>" \
  -d '{
    "event": "avatar.completed",
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "completed",
    "avatar_url": "https://example.com/avatar.png"
  }'

from flask import Flask, request, abort
import hmac, hashlib

app = Flask(__name__)
API_KEY = "dppl_YOUR_KEY_HERE"

def verify(body, sig):
    digest = "sha256=" + hmac.new(
        API_KEY.encode(), body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(digest, sig or "")

@app.route("/webhooks/doppl", methods=["POST"])
def handle():
    body = request.get_data()
    if not verify(body, request.headers.get("X-Doppl-Signature")):
        return abort(401)
    payload = request.get_json()
    print("avatar:", payload["avatar_url"])
    return ("", 200)

const express = require("express");
const crypto = require("crypto");
const API_KEY = "dppl_YOUR_KEY_HERE";
const verify = (raw, sig) => {
  const want = "sha256=" + crypto.createHmac("sha256", API_KEY).update(raw).digest("hex");
  return sig && crypto.timingSafeEqual(Buffer.from(want), Buffer.from(sig));
};
express().post("/webhooks/doppl",
  express.raw({ type: "application/json" }),
  (req, res) => {
    if (!verify(req.body, req.get("X-Doppl-Signature"))) return res.status(401).end();
    const payload = JSON.parse(req.body.toString());
    console.log("avatar:", payload.avatar_url);
    res.status(200).end();
  }
).listen(3000);