CDN

v1 stable

Hospedagem de imagens com links públicos, organizada por projetos e pastas.

base url https://flye.win/v1/cdn

visão geral

Envie imagens de até 100 MB e receba um link público pronto para usar no site, no app ou no bot. Organize por projetos e pastas, acompanhe o espaço usado e gerencie tudo também pelo painel. Cada projeto é só seu: outras contas não listam, não acessam pela API e não apagam o que você enviou.

Autenticação, formato de erro e limites são iguais em todas as APIs — veja a documentação geral.

planos

Starter

Black Friday

US$ 2,89 no 1º mês

~~US$ 3,59~~ · depois US$ 3,59/mês

até 30 nov 2026

Para sites e bots pequenos.

quota/mês: 20.000
req/min: 60

5 GB de armazenamento
Arquivos de até 20 MB
Até 5 projetos
20.000 requisições / mês
Visualizações das imagens ilimitadas

Criar conta para assinar

Cartão

Pro

Black Friday

US$ 5,29 no 1º mês

~~US$ 9,09~~ · depois US$ 9,09/mês

até 30 nov 2026

Para lojas e aplicações em produção.

quota/mês: 500.000
req/min: 300

50 GB de armazenamento
Arquivos de até 50 MB
Até 25 projetos
500.000 requisições / mês
Visualizações das imagens ilimitadas

Criar conta para assinar

Cartão

Business

Black Friday

US$ 45,59 no 1º mês

~~US$ 54,89~~ · depois US$ 54,89/mês

até 30 nov 2026

Sem limites de espaço, requisições ou projetos.

quota/mês: ilimitado
req/min: 1.200

Armazenamento ilimitado
Requisições ilimitadas no mês
Projetos ilimitados
Arquivos de até 100 MB
Visualizações das imagens ilimitadas
Suporte prioritário

Criar conta para assinar

Cartão

Sua chave para testar aqui Pegar uma chave

Use uma chave de teste (flye_test_…): ela responde com os exemplos, sem gastar cota e sem precisar de plano. A chave fica só nesta aba do navegador e não é enviada ao nosso site.

POST /v1/cdn/upload — Enviar imagem

Envia uma imagem em multipart/form-data. O projeto é criado na primeira vez que você o usa. Aceita jpg, jpeg, png, gif, webp, svg, até o limite por arquivo do seu plano. O tipo é conferido pelo conteúdo do arquivo, e SVG com script ou links externos é recusado.

parâmetro	onde	tipo	descrição
image*	form	file	O arquivo. Também aceito com o nome file.
project*	form	string	Nome do projeto: letras, números, - e _, até 48 caracteres. Maiúsculas viram minúsculas.
folder	form	string	Pasta dentro do projeto, opcional, com as mesmas regras do nome.

curl -X POST "https://flye.win/v1/cdn/upload" \
  -H "Authorization: Bearer $FLYE_KEY" \
  -F "[email protected]" \
  -F "project=loja" \
  -F "folder=produtos"

const form = new FormData();
form.append("image", await fetch("./foto.jpg").then((r) => r.blob()), "foto.jpg"); // ou um <input type="file">
form.append("project", "loja");
form.append("folder", "produtos");

const res = await fetch("https://flye.win/v1/cdn/upload", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
  body: form,
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.post(
    "https://flye.win/v1/cdn/upload",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    files={"image": open("foto.jpg", "rb")},
    data={"project": "loja", "folder": "produtos"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

var buf bytes.Buffer
w := multipart.NewWriter(&buf)
file, _ := os.Open("foto.jpg")
part, _ := w.CreateFormFile("image", "foto.jpg")
io.Copy(part, file)
w.WriteField("project", "loja")
w.WriteField("folder", "produtos")
w.Close()

req, _ := http.NewRequest("POST", "https://flye.win/v1/cdn/upload", &buf)
req.Header.Set("Content-Type", w.FormDataContentType())
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/upload');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
    CURLOPT_POSTFIELDS => ['image' => new CURLFile('foto.jpg'), 'project' => 'loja', 'folder' => 'produtos'],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "id": "6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40",
  "project": "loja",
  "folder": "produtos",
  "filename": "1743580800000000000.jpg",
  "original_name": "tenis-azul.jpg",
  "url": "https://cdn.flye.win/images/fw_9c41d2e07ab3f5168e2d/produtos/1743580800000000000.jpg",
  "size": 204800,
  "content_type": "image/jpeg",
  "created_at": "2026-11-02T13:30:00Z"
}

Testar agora

GET /v1/cdn/projects — Listar projetos

Lista os projetos da sua conta, com quantidade de imagens e espaço usado em cada um.

curl "https://flye.win/v1/cdn/projects" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/cdn/projects", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/cdn/projects",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/cdn/projects", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/projects');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "projects": [
    { "name": "loja", "images": 128, "bytes": 52428800, "created_at": "2026-10-01T12:00:00Z" }
  ]
}

Testar agora

POST /v1/cdn/projects — Criar projeto

Cria um projeto vazio. Opcional: o envio já cria o projeto quando ele não existe.

parâmetro	onde	tipo	descrição
name*	body	string	Nome do projeto.

curl -X POST "https://flye.win/v1/cdn/projects" \
  -H "Authorization: Bearer $FLYE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"loja"}'

const res = await fetch("https://flye.win/v1/cdn/projects", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"name":"loja"}),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.post(
    "https://flye.win/v1/cdn/projects",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    json={"name": "loja"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

body := strings.NewReader(`{"name":"loja"}`)
req, _ := http.NewRequest("POST", "https://flye.win/v1/cdn/projects", body)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/projects');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"name":"loja"}',
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{ "name": "loja", "images": 0, "bytes": 0, "created_at": "2026-11-02T13:30:00Z" }

Testar agora

GET /v1/cdn/projects/{project} — Listar imagens

Lista as imagens do projeto, das mais novas para as mais antigas, e as pastas que ele tem.

parâmetro	onde	tipo	descrição
project*	path	string	Nome do projeto.
folder	query	string	Só as imagens desta pasta. Sem ele, todas as imagens do projeto. Use / para só as que estão fora de pastas.
page	query	integer	Página, a partir de 1.
per_page	query	integer	Itens por página, de 1 a 100. Padrão 20.

curl "https://flye.win/v1/cdn/projects/loja?folder=produtos&page=1" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/cdn/projects/loja?folder=produtos&page=1", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/cdn/projects/loja?folder=produtos&page=1",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/cdn/projects/loja?folder=produtos&page=1", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/projects/loja?folder=produtos&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "project": "loja",
  "folders": [{ "name": "produtos", "images": 96 }],
  "images": [{
    "id": "6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40",
    "project": "loja",
    "folder": "produtos",
    "filename": "1743580800000000000.jpg",
    "original_name": "tenis-azul.jpg",
    "url": "https://cdn.flye.win/images/fw_9c41d2e07ab3f5168e2d/produtos/1743580800000000000.jpg",
    "size": 204800,
    "content_type": "image/jpeg",
    "created_at": "2026-11-02T13:30:00Z"
  }],
  "pagination": { "page": 1, "per_page": 20, "total": 96, "total_pages": 5 }
}

Testar agora

GET /v1/cdn/images/{id} — Detalhes de uma imagem

Devolve uma imagem da sua conta pelo id recebido no envio.

parâmetro	onde	tipo	descrição
id*	path	string	Id da imagem.

curl "https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "id": "6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40",
  "project": "loja",
  "folder": "produtos",
  "filename": "1743580800000000000.jpg",
  "original_name": "tenis-azul.jpg",
  "url": "https://cdn.flye.win/images/fw_9c41d2e07ab3f5168e2d/produtos/1743580800000000000.jpg",
  "size": 204800,
  "content_type": "image/jpeg",
  "created_at": "2026-11-02T13:30:00Z"
}

Testar agora

DELETE /v1/cdn/images/{id} — Apagar imagem

Apaga a imagem e libera o espaço na hora. O link deixa de funcionar em instantes.

parâmetro	onde	tipo	descrição
id*	path	string	Id da imagem.

curl -X DELETE "https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.delete(
    "https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("DELETE", "https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/images/6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{ "deleted": true, "id": "6f1c2a9e-4b7d-4e1a-9c3f-2d8b7a6e5f40" }

Testar agora

DELETE /v1/cdn/projects/{project} — Apagar projeto

Apaga o projeto com todas as imagens dele e libera o espaço na hora. Não dá para desfazer.

parâmetro	onde	tipo	descrição
project*	path	string	Nome do projeto.

curl -X DELETE "https://flye.win/v1/cdn/projects/loja" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/cdn/projects/loja", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.delete(
    "https://flye.win/v1/cdn/projects/loja",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("DELETE", "https://flye.win/v1/cdn/projects/loja", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/projects/loja');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{ "deleted": true, "project": "loja", "images": 128 }

Testar agora

GET /v1/cdn/usage — Espaço e limites

Mostra o espaço usado, os limites do plano e o maior arquivo aceito. Limite null significa ilimitado.

curl "https://flye.win/v1/cdn/usage" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/cdn/usage", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/cdn/usage",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/cdn/usage", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/cdn/usage');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "storage": { "used_bytes": 52428800, "limit_bytes": 5368709120 },
  "max_file_bytes": 20971520,
  "images": 128,
  "projects": { "used": 1, "limit": 5 }
}

Testar agora