Create private custom avatar
curl --request POST \
--url https://app.famulor.io/api/v1/avatars \
--header 'Content-Type: application/json' \
--data '
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"consent": true,
"expected_credits": 499999999.5
}
'import requests
url = "https://app.famulor.io/api/v1/avatars"
payload = {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"consent": True,
"expected_credits": 499999999.5
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
consent: true,
expected_credits: 499999999.5
})
};
fetch('https://app.famulor.io/api/v1/avatars', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.io/api/v1/avatars",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'consent' => true,
'expected_credits' => 499999999.5
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.io/api/v1/avatars"
payload := strings.NewReader("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"consent\": true,\n \"expected_credits\": 499999999.5\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.famulor.io/api/v1/avatars")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"consent\": true,\n \"expected_credits\": 499999999.5\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/avatars")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"consent\": true,\n \"expected_credits\": 499999999.5\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"style": "realistic",
"status": "awaiting_upload",
"creation_credits": 1,
"error_code": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"image_url": "<string>",
"preview_video_url": "<string>"
}
}
AI Assistants
Custom AI avatars — submit
Submit a prepared photo after uploading it. A user-bound credential and image consent are required. Credits are reserved, then charged once after successful creation. Definite failures release the reservation. Ambiguous results keep the reservation while processing is reconciled. Reuse the same ID after a timeout. The saved automatic top-up rule may fund insufficient credits; otherwise 402 directs the caller to add credits. Live usage is billed separately. Required scope: assistants:write.
POST
/
avatars
Create private custom avatar
curl --request POST \
--url https://app.famulor.io/api/v1/avatars \
--header 'Content-Type: application/json' \
--data '
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"consent": true,
"expected_credits": 499999999.5
}
'import requests
url = "https://app.famulor.io/api/v1/avatars"
payload = {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"consent": True,
"expected_credits": 499999999.5
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
consent: true,
expected_credits: 499999999.5
})
};
fetch('https://app.famulor.io/api/v1/avatars', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.io/api/v1/avatars",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'consent' => true,
'expected_credits' => 499999999.5
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.io/api/v1/avatars"
payload := strings.NewReader("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"consent\": true,\n \"expected_credits\": 499999999.5\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.famulor.io/api/v1/avatars")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"consent\": true,\n \"expected_credits\": 499999999.5\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/avatars")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"consent\": true,\n \"expected_credits\": 499999999.5\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"style": "realistic",
"status": "awaiting_upload",
"creation_credits": 1,
"error_code": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"image_url": "<string>",
"preview_video_url": "<string>"
}
}
MCP:
submit_avatar · CLI: famulor submit-avatarBody
application/json