media

Importar uma foto ou um vídeo de banco de imagens

Copia um resultado da pesquisa, identificado pelo provedor e pelo id, para a mídia do site (imagens com até 2400 px de largura e vídeos de até full HD), incluindo o texto alternativo e os créditos. Grátis.

POST/v1/sites/{site_id}/media/stock

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/media/stock' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "pixabay",
  "id": "<string>"
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/media/stock"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"provider\":\"pixabay\",\"id\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/media/stock", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "provider": "pixabay",
    "id": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>/media/stock");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"provider\":\"pixabay\",\"id\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.atelier201.com/v1/sites/<site_id>/media/stock", bytes.NewBuffer([]byte("{\"provider\":\"pixabay\",\"id\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/sites/<site_id>/media/stock"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"provider\":\"pixabay\",\"id\":\"<string>\"}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/sites/<site_id>/media/stock")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"provider\":\"pixabay\",\"id\":\"<string>\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "path": "<string>",
    "url_path": "<string>",
    "mime": "<string>",
    "size": 123,
    "alt": null,
    "credit": null,
    "source_url": null,
    "keep_original": true,
    "source": {},
    "next_action": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

Requer sites:write. Não custa créditos.

Envie o provider e o id do resultado da busca. O arquivo é copiado para a mídia do site: fotos com até 2400 pixels de largura e vídeos em até Full HD e com no máximo 20 MB. Se o nome já estiver em uso, será acrescentado um sufixo, para que a importação nunca substitua um arquivo existente no site.

A mídia mantém seu credit (“Photo by Jane Doe on Pixabay”) e sua source_url. O Pixabay não exige créditos no site, mas é uma boa prática incluir uma linha curta de créditos.

Imagens de banco ajudam a criar um clima. Elas nunca substituem os produtos, as pessoas ou as instalações reais da empresa.

Conta para o limite de 30 buscas e importações por minuto por workspace, compartilhado com a busca.

Autorizações

Authorizationbearerin headerrequired

Parâmetros de caminho

site_idstringrequired

O id do site ou seu slug (o endereço antes de .atelier201.page).

Corpo

application/jsonrequired

providerenum<string>requiredone of: pixabay

idstringrequiredlength: 1–20 chars

O id do resultado, obtido na pesquisa.

kindenum<string>one of: image, video

filenamestringlength: 1–100 chars

Um nome sem extensão; por padrão, usa a descrição.

altstringlength: ≤ 300 chars

O que a imagem mostra, para quem não consegue vê-la. Por padrão, usa a descrição da biblioteca.

Resposta

application/json

Importar uma foto ou um vídeo de banco de imagens

dataRecord<string, object>required

Show child attributes

data.pathstringrequired

data.url_pathstringrequired

data.mimestringrequired

data.sizeintegerrequiredrange: -9007199254740991–9007199254740991

data.altstringnullrequired

data.creditstringnullrequired

Quem criou o conteúdo, quando a licença exige essa informação: "Photo by Jane Doe on Pixabay", "Generated with Seedream 5 Lite (ByteDance)". Null para arquivos enviados.

data.source_urlstringnullrequired

A página de banco de imagens de onde veio, ou null.

data.keep_originalbooleanrequired

Armazenado exatamente como foi enviado, sem nunca ser recodificado durante uma build. Caso contrário, imagens com mais de 200 KB são comprimidas ao chegar (no máximo 2000 px, para cerca de 150 KB, qualidade 75 ou superior, metadados removidos).

data.sourceRecord<string, object>required

data.next_actionstringrequired

request_idstringrequired

curl --request POST \ --url 'https://api.atelier201.com/v1/sites/<site_id>/media/stock' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "provider": "pixabay", "id": "<string>" }'

{ "data": { "path": "<string>", "url_path": "<string>", "mime": "<string>", "size": 123, "alt": null, "credit": null, "source_url": null, "keep_original": true, "source": {}, "next_action": "<string>" }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Importar uma foto ou um vídeo de banco de imagens

Autorizações

Parâmetros de caminho

Corpo

Resposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies