Get a pose
curl --request GET \
--url https://api.budgetpixel.com/v1/poses/{handle} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.budgetpixel.com/v1/poses/{handle}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.budgetpixel.com/v1/poses/{handle}', 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://api.budgetpixel.com/v1/poses/{handle}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.budgetpixel.com/v1/poses/{handle}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.budgetpixel.com/v1/poses/{handle}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.budgetpixel.com/v1/poses/{handle}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"how_to_use": "<string>",
"pose": {
"cover": {
"angle": "front",
"azimuth": 0,
"elevation": 0,
"figure": "woman",
"height": 1152,
"id": "<string>",
"label": "Back left · from above",
"made_by": "<string>",
"mention": "@seiza_pose.back",
"thumbnail_url": "<string>",
"url": "<string>",
"view": true,
"width": 864
},
"created_at": "2023-11-07T05:31:56Z",
"creator": {
"display_name": "<string>",
"username": "<string>"
},
"description": "Sits on the floor leaning back, the weight on both palms placed flat behind the hips. One knee is bent up towards the chest, the other leg stretched out straight and relaxed. The torso angles slightly back and the head faces forward.",
"difficulty": "everyday",
"fit": "women",
"handle": "sitting_knee_up_pose",
"holdable": true,
"id": "<string>",
"mention": "@sitting_knee_up_pose",
"name": "Sitting Knee Up",
"pictures": [
{
"angle": "front",
"azimuth": 0,
"elevation": 0,
"figure": "woman",
"height": 1152,
"id": "<string>",
"label": "Back left · from above",
"made_by": "<string>",
"mention": "@seiza_pose.back",
"thumbnail_url": "<string>",
"url": "<string>",
"view": true,
"width": 864
}
],
"props": [
"chair"
],
"rating": 0,
"shelf": "sitting",
"shelf_label": "Sitting",
"slug": "sitting-knee-up-pose",
"source": "house",
"support": "sitting",
"tags": [
"floor",
"relaxed"
],
"uses": 123,
"view_count": 3
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}Poses
Get a pose
One pose in full: its description word for word (the text a mention adds to the prompt)
and every mannequin picture, by figure (woman, man) and by place on the Camera
Angles globe (azimuth, elevation, label): the pose’s own pictures and the views
members made (view: true, made_by). Each picture’s mention asks for that view in a
prompt: @seiza_pose.back. A place without a view can be made with
POST /v1/poses/{handle}/views.
Free — no credits. Limited to 200 calls per day and 30 a minute per account.
GET
/
poses
/
{handle}
Get a pose
curl --request GET \
--url https://api.budgetpixel.com/v1/poses/{handle} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.budgetpixel.com/v1/poses/{handle}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.budgetpixel.com/v1/poses/{handle}', 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://api.budgetpixel.com/v1/poses/{handle}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.budgetpixel.com/v1/poses/{handle}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.budgetpixel.com/v1/poses/{handle}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.budgetpixel.com/v1/poses/{handle}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"how_to_use": "<string>",
"pose": {
"cover": {
"angle": "front",
"azimuth": 0,
"elevation": 0,
"figure": "woman",
"height": 1152,
"id": "<string>",
"label": "Back left · from above",
"made_by": "<string>",
"mention": "@seiza_pose.back",
"thumbnail_url": "<string>",
"url": "<string>",
"view": true,
"width": 864
},
"created_at": "2023-11-07T05:31:56Z",
"creator": {
"display_name": "<string>",
"username": "<string>"
},
"description": "Sits on the floor leaning back, the weight on both palms placed flat behind the hips. One knee is bent up towards the chest, the other leg stretched out straight and relaxed. The torso angles slightly back and the head faces forward.",
"difficulty": "everyday",
"fit": "women",
"handle": "sitting_knee_up_pose",
"holdable": true,
"id": "<string>",
"mention": "@sitting_knee_up_pose",
"name": "Sitting Knee Up",
"pictures": [
{
"angle": "front",
"azimuth": 0,
"elevation": 0,
"figure": "woman",
"height": 1152,
"id": "<string>",
"label": "Back left · from above",
"made_by": "<string>",
"mention": "@seiza_pose.back",
"thumbnail_url": "<string>",
"url": "<string>",
"view": true,
"width": 864
}
],
"props": [
"chair"
],
"rating": 0,
"shelf": "sitting",
"shelf_label": "Sitting",
"slug": "sitting-knee-up-pose",
"source": "house",
"support": "sitting",
"tags": [
"floor",
"relaxed"
],
"uses": 123,
"view_count": 3
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}{
"error": {
"code": "model_not_available",
"message": "<string>",
"type": "invalid_request_error"
}
}Authorizations
API key as a bearer token: Authorization: Bearer bpx_live_xxx
Path Parameters
The pose's handle, with or without the @ (sitting_knee_up_pose).