Frequentemente, usuários perguntam em nossos grupos de suporte: "Como configuro o Nano Banana no Coze?", "O N8N tem algum nó pronto para a APIYI?", "O ComfyUI consegue integrar com Sora/SeeDance?". Essas perguntas estão entre os tópicos mais marcados (@) em nosso suporte.
Para permitir que mais desenvolvedores e criadores de conteúdo acessem as capacidades dos modelos da plataforma APIYI (apiyi.com) com baixa barreira de entrada, lançamos oficialmente o "Programa de Recompensa de Plugins Open Source da APIYI": estamos coletando plugins de código aberto para os três principais ecossistemas de fluxo de trabalho — Coze / N8N / ComfyUI — oferecendo recompensas em dinheiro ou créditos na plataforma. Todos os trabalhos selecionados serão publicados no centro de documentação da APIYI com o nome do colaborador, ficando disponíveis gratuitamente para todos os usuários.
Se você já criou nós, plugins ou modelos de fluxo de trabalho semelhantes, ou se deseja implementar um, este artigo detalha os critérios de recompensa, requisitos técnicos e o processo de envio. Convidamos você a trazer seu código e aproveitar esta oportunidade!
Visão geral do Programa de Recompensa
Este programa é voltado para todos os desenvolvedores interessados em fluxos de trabalho de IA e desenvolvimento de plugins. Não há barreiras de entrada ou restrições de perfil; desde que seu trabalho passe pela nossa avaliação, você receberá a recompensa correspondente.
Plataformas-alvo da recompensa
Os três principais cenários de integração que mais interessam aos usuários da APIYI (apiyi.com) atualmente:
| Plataforma | Público-alvo | Tipos de plugin adequados | Prioridade |
|---|---|---|---|
| Coze | Desenvolvedores de Bot no-code | Geração de imagem, vídeo, plugins de modelo de chat | ⭐⭐⭐⭐⭐ |
| N8N | Entusiastas de automação | Nós de LLM genéricos, nós de processamento em lote | ⭐⭐⭐⭐⭐ |
| ComfyUI | Criadores de imagem/vídeo | Nós para Nano Banana, SeeDance, Sora | ⭐⭐⭐⭐⭐ |
| Dify | Desenvolvedores de base de conhecimento | Adaptadores de integração de modelo | ⭐⭐⭐⭐ |
| FastGPT | Construção de Q&A | Plugins de modelo de chat | ⭐⭐⭐ |
| n8n-nodes-custom | Mercado de nós da comunidade | Publicação no repositório npm | ⭐⭐⭐⭐ |
Mecanismo de recompensa
Para recompensar de forma justa o tempo investido pelos colaboradores, estabelecemos dois níveis de premiação:
| Tipo de recompensa | Nível Padrão | Nível Premium | Observação |
|---|---|---|---|
| Recompensa em dinheiro | ¥300 – ¥800 | ¥1000 – ¥3000 | Definido pela completude e utilidade |
| Créditos APIYI | ¥500 – ¥1500 | ¥2000 – ¥5000 | Crédito equivalente para consumo |
| Direitos de autoria | ✅ Página de autor no docs | ✅ Destaque na home + entrevista | Permanente |
| Licença | Open Source MIT/Apache 2.0 | Open Source MIT/Apache 2.0 | Autor mantém direitos |
💡 Dica de envio: Se você já possui um trabalho pronto, basta organizá-lo conforme a lista no final deste artigo e enviá-lo. O ciclo de avaliação é de 3 a 5 dias úteis. Contato para envio: seção "Programa de Desenvolvedores" no rodapé do site APIYI (apiyi.com), ou adicione nosso atendimento oficial no WeChat com a observação "Recompensa de Plugin".
Direcionamentos e Pontos Técnicos para o Desenvolvimento de Plugins Coze
O Coze é uma plataforma de desenvolvimento de IA Bot sem código lançada pela ByteDance. Embora possua uma grande base de usuários, o mercado oficial de plugins ainda exige a configuração manual de serviços de API para a integração de modelos de terceiros. Esperamos que os plugins Coze enviados cubram as seguintes áreas.
Direção 1: Plugins de Geração de Imagens (Recompensa Máxima)
O objetivo principal é permitir que o Coze Bot invoque diretamente os modelos de geração de imagens da APIYI, incluindo, mas não se limitando a:
- Série Nano Banana: Nano Banana, Nano Banana Pro (gemini-3-pro-image)
- Série GPT-Image: gpt-image-1, gpt-image-1-mini
- Série Flux: Flux Pro, Flux Dev, Flux Schnell
- Recraft V3, Ideogram 3, Midjourney v7, etc.
Requisitos mínimos de funcionalidade do plugin:
- Suporte a texto para imagem (Text-to-Image)
- Suporte a edição de imagem para imagem (Image-to-Image)
- Suporte a parâmetros de resolução e proporção
- Retorno de URL da imagem que possa ser exibida diretamente no fluxo de mensagens do Coze
- Mensagens de erro amigáveis
Direção 2: Plugins de Geração de Vídeo
Focados no encapsulamento de APIs de geração de vídeo assíncrona como SeeDance, Sora, Kling, Veo, etc.:
| Modelo | Endpoint da API | O que o plugin deve processar |
|---|---|---|
| SeeDance 2.0 | /videos assíncrono |
Envio de tarefa + sondagem de status |
| Sora 2 | /video/generations |
Suporte ao modo de callback |
| Kling 2 | /kling/videos |
Adaptação de múltiplas resoluções |
| Veo 3 | /google/veo |
Roteamento regional |
Direção 3: Plugins de Conversação e Chamada de Ferramentas
Encapsulamento de diversos modelos de conversação como Claude, GPT, Gemini, DeepSeek, etc., com suporte a function calling, uso de ferramentas e saída em streaming.
Exemplo de código para invocação de plugin Coze
Implementação típica de uma Ação de plugin Coze (JavaScript):
export async function handler({ input, context }) {
const { prompt, aspect_ratio = "16:9" } = input;
const response = await fetch(
"https://vip.apiyi.com/v1/images/generations",
{
method: "POST",
headers: {
"Authorization": `Bearer ${context.apiyi_key}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "gemini-3-pro-image",
prompt: prompt,
n: 1,
size: aspect_ratio === "16:9" ? "1920x1080" : "1024x1024"
})
}
);
const data = await response.json();
return { image_url: data.data[0].url };
}
🎯 Dica técnica: A chave API do plugin Coze deve ser armazenada através de variáveis de credencial do Coze, evitando o hardcoding. Recomendamos que os autores de plugins expliquem claramente no README como solicitar uma chave exclusiva no painel da APIYI (apiyi.com) e forneçam uma estimativa de consumo de créditos para que o usuário tenha controle.
Direcionamentos e Pontos Técnicos para o Desenvolvimento de Plugins N8N
O N8N é uma plataforma de fluxo de trabalho de automação de código aberto com grande influência entre desenvolvedores nacionais e internacionais. Seu sistema de nós é baseado em TypeScript, tornando o desenvolvimento e a publicação relativamente padronizados.
Quatro formas de desenvolvimento de nós N8N
| Forma | Complexidade | Cenário de Aplicação | Exemplo |
|---|---|---|---|
| Credential Node | Baixa | Autenticação unificada com chave APIYI | Credencial de API APIYI |
| Action Node | Média | Encapsulamento de invocação de modelo único | Geração de Imagem APIYI |
| Trigger Node | Alta | Escuta de callback/Webhook | Conclusão de Tarefa de Vídeo APIYI |
| Declarative Node | Baixa | Nó de descrição JSON | Protótipo rápido |
Lista de funcionalidades recomendadas para nós N8N
Os plugins enviados devem cobrir pelo menos os seguintes nós principais:
- Credenciais APIYI: Gerenciamento unificado de URL Base, chave API e configurações de proxy
- Modelo de Chat APIYI: Conexão com modelos de conversação GPT/Claude/Gemini/DeepSeek
- Geração de Imagem APIYI: Geração de imagens com Nano Banana / Flux / GPT-Image
- Geração de Vídeo APIYI: Geração de vídeo com SeeDance/Sora/Kling, com sondagem interna
- Lote APIYI: Gerenciamento de tarefas de processamento em lote via OpenAI /v1/batches
- Embedding APIYI: Nós de vetorização como text-embedding-3, etc.
Exemplo de implementação mínima de nó N8N
Abaixo está uma estrutura de nó de geração de imagem APIYI que segue o padrão N8N (TypeScript):
import { IExecuteFunctions, INodeType, INodeTypeDescription } from 'n8n-workflow';
export class ApiyiImage implements INodeType {
description: INodeTypeDescription = {
displayName: 'APIYI Image',
name: 'apiyiImage',
group: ['transform'],
version: 1,
credentials: [{ name: 'apiyiApi', required: true }],
properties: [
{ displayName: 'Modelo', name: 'model', type: 'options',
options: [
{ name: 'Nano Banana Pro', value: 'gemini-3-pro-image' },
{ name: 'GPT Image 1', value: 'gpt-image-1' },
{ name: 'Flux Pro', value: 'flux-pro-1.1' }
], default: 'gemini-3-pro-image' },
{ displayName: 'Comando', name: 'prompt', type: 'string', default: '' }
]
};
async execute(this: IExecuteFunctions) {
const creds = await this.getCredentials('apiyiApi');
const model = this.getNodeParameter('model', 0) as string;
const prompt = this.getNodeParameter('prompt', 0) as string;
const res = await this.helpers.request({
method: 'POST',
uri: `${creds.baseUrl}/v1/images/generations`,
headers: { Authorization: `Bearer ${creds.apiKey}` },
body: { model, prompt }, json: true
});
return [this.helpers.returnJsonArray([res])];
}
}
⚡ Sugestão de publicação: Plugins N8N de alta qualidade devem ser publicados simultaneamente no repositório npm (seguindo a regra de nomenclatura
n8n-nodes-apiyi-*) e também como código aberto no GitHub. Recomendaremos os plugins em destaque no centro de documentação da APIYI (apiyi.com) e forneceremos uma página dedicada aos contribuidores.
Direções de Desenvolvimento e Pontos Técnicos para Plugins do ComfyUI
O ComfyUI é o fluxo de trabalho de nós mais ativo para criadores de IA de imagem/vídeo. Ele possui uma arquitetura Python de código aberto e um ecossistema de nós comunitários bastante próspero.
Valor Central dos Plugins do ComfyUI
Comparado aos modelos locais nativos, a integração com modelos em nuvem da APIYI oferece:
- Sem necessidade de GPU local, utilizável em notebooks leves
- Suporte a modelos de código fechado que não podem ser implantados localmente, como Sora 2, SeeDance 2.0, Kling 2, etc.
- Suporte para geração de imagens em alta resolução (4K/8K) sem pressão na VRAM
- Gerenciamento unificado de múltiplos modelos via API, reduzindo custos de troca
Lista de Nós do ComfyUI Recomendados para Coleta
| Nome do Nó | Função Principal | Equivalente Nativo |
|---|---|---|
| APIYI_NanoBananaPro | Geração de imagem Google Nano Banana Pro | KSampler + SDXL |
| APIYI_GPTImage | Geração/Edição de imagem OpenAI gpt-image-1 | Flux Dev |
| APIYI_SeeDance | Vídeo texto para vídeo/imagem para vídeo SeeDance 2.0 | AnimateDiff |
| APIYI_Sora2 | Geração de vídeo Sora 2 | – (Sem equivalente local) |
| APIYI_Kling2 | Geração de vídeo Kling 2 | – |
| APIYI_Upscaler | Upscaling de imagem (Recraft/Topaz) | Ultimate SD Upscaler |
| APIYI_ChatNode | Nó de texto para modelo de chat | – |
| APIYI_BatchRunner | Executor de tarefas em lote | Batch Image Loader |
Exemplo de Implementação Mínima de Nó ComfyUI
Um nó personalizado do ComfyUI é uma classe Python que pode ser carregada colocando-a no diretório ComfyUI/custom_nodes/:
import requests, os
from PIL import Image
import io, numpy as np, torch
class APIYINanoBananaPro:
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"prompt": ("STRING", {"multiline": True}),
"aspect_ratio": (["1:1", "16:9", "9:16", "4:3"],),
"api_key": ("STRING", {"default": ""})
}
}
RETURN_TYPES = ("IMAGE",)
FUNCTION = "generate"
CATEGORY = "APIYI/Image"
def generate(self, prompt, aspect_ratio, api_key):
# Envia a solicitação para a API da APIYI
resp = requests.post(
"https://vip.apiyi.com/v1/images/generations",
headers={"Authorization": f"Bearer {api_key}"},
json={"model": "gemini-3-pro-image",
"prompt": prompt, "size": aspect_ratio}
)
url = resp.json()["data"][0]["url"]
img_bytes = requests.get(url).content
img = Image.open(io.BytesIO(img_bytes)).convert("RGB")
arr = np.array(img).astype(np.float32) / 255.0
return (torch.from_numpy(arr)[None,],)
NODE_CLASS_MAPPINGS = {"APIYI_NanoBananaPro": APIYINanoBananaPro}
NODE_DISPLAY_NAME_MAPPINGS = {"APIYI_NanoBananaPro": "APIYI Nano Banana Pro"}
Padrões de Submissão e Dimensões de Avaliação
Para que trabalhos excelentes sejam selecionados mais rapidamente, estabelecemos dimensões de avaliação claras. Recomendamos verificar estes pontos antes de enviar.
Requisitos Básicos Obrigatórios
- Licença de código aberto: Uma entre MIT / Apache 2.0 / GPL v3
- Repositório de código: Repositório público no GitHub / GitLab / Gitee
- Documentação completa: README contendo instalação, configuração e exemplos de uso
- Testável e funcional: Fornecer pelo menos 1 demonstração mínima funcional
- Compatível com APIYI: Usar o
base_urlpadrão da APIYI (apiyi.com) e autenticação com chave API
Requisitos Adicionais para a Categoria Premium
Para concorrer às faixas de ¥3000 / ¥5000, é necessário cumprir adicionalmente:
- Cobertura de múltiplos modelos (≥ 5 modelos principais)
- Tratamento de erros robusto (timeout, limitação de taxa, erros de parâmetro)
- README bilíngue (Chinês e Inglês)
- Incluir 3+ modelos de exemplo de fluxo de trabalho
- Gravar um vídeo de uso de 3 a 5 minutos
Pontos Extras na Avaliação
- Ser o primeiro plugin a cobrir uma plataforma escassa (ex: Dify, FastGPT)
- Código conciso e sustentável (arquivo único ≤ 500 linhas com alta legibilidade)
- Plano de atualização contínua
- Já estar sendo usado espontaneamente por usuários da comunidade (GitHub star ≥ 20)
Perguntas Frequentes (FAQ) sobre Recompensas
Q1: Já criei um plugin semelhante, posso solicitar a recompensa diretamente?
Com certeza, e é muito bem-vindo. Desde que o plugin atenda aos "requisitos básicos" e seja adaptado para o base_url e as normas de chave da APIYI (apiyi.com) — o que pode exigir apenas ajustes leves —, você pode enviá-lo para avaliação. Projetos no GitHub com alto nível de conclusão geralmente entram direto na categoria premium. Ao enviar, anexe o link do repositório e uma breve lista de verificação; daremos o primeiro feedback em até 3 dias úteis.
Q2: Posso escolher receber a recompensa em dinheiro e em créditos da APIYI simultaneamente?
Sim, você pode combinar as formas de recebimento. Por exemplo, para uma recompensa premium de ¥3000, você pode optar por ¥1500 em dinheiro + ¥1500 em créditos na plataforma, ou converter o valor total em créditos (taxa de conversão de 1:1.3, ou seja, ¥3000 em dinheiro equivalem a ¥3900 em créditos). Os detalhes podem ser negociados com a equipe da APIYI (apiyi.com) após a aprovação do envio, e faremos o pagamento conforme sua preferência.
Q3: Após tornar o plugin open source, ainda mantenho os direitos autorais?
Você mantém todos os direitos autorais e de autoria. A APIYI solicita apenas o direito de uso não exclusivo e o direito de exibição em nossa central de documentação. Você pode continuar a manter, distribuir e comercializar seu trabalho. Também incentivamos que você construa sua reputação open source a partir disso e, caso tenha demandas futuras, podemos conversar sobre uma colaboração conjunta.
Q4: Quantos trabalhos uma pessoa pode enviar? Existe um limite?
Não há limite. O mesmo colaborador pode enviar trabalhos para as plataformas Coze, N8N e ComfyUI separadamente, sendo cada um avaliado e recompensado individualmente. Já vimos colaboradores enviarem um "conjunto de plugins para três plataformas de uma só vez" e receberem 3 recompensas de categoria premium. Valorizamos muito esse tipo de contribuição sistêmica.
Q5: Se várias pessoas enviarem o mesmo tipo de plugin ao mesmo tempo, como é feita a avaliação?
Avaliamos com base em dois critérios: "quem enviou primeiro com alta qualidade" e "abrangência funcional". Mesmo que um trabalho chegue depois, se ele for significativamente superior em termos de funcionalidades ou qualidade de código, será selecionado e receberá a recompensa integral. Após a seleção, ambos os trabalhos serão exibidos na central de documentação, permitindo que os usuários escolham livremente, sem qualquer tipo de "exclusividade".
Q6: Quanto tempo leva para receber um feedback após o envio?
Processo padrão: primeira avaliação e feedback em até 3 dias úteis, com a recompensa sendo liberada em até 5 dias úteis após a aprovação. A categoria premium pode exigir etapas adicionais de auditoria de código e verificação de documentação, não excedendo 10 dias úteis no total. Manteremos você informado sobre o progresso via e-mail e WeChat.
Processo de Envio e Contato
Fluxo de Envio Padrão
Após preparar seu trabalho, siga estas etapas para enviar:
- Organize o repositório: Certifique-se de que o repositório no GitHub/Gitee esteja público, com um README completo e um demo funcional.
- Preencha o formulário de envio: Acesse APIYI (apiyi.com) → Central de Documentação → página "Programa de Desenvolvedores" e preencha o formulário.
- Forneça os dados: Link do repositório, breve descrição do plugin, forma de recompensa preferida e informações de contato.
- Aguarde a avaliação: Receba o primeiro feedback em até 3 dias úteis.
- Revisão e definição: Após as revisões (se houver), o trabalho será classificado e selecionado.
- Pagamento da recompensa: O valor em dinheiro será enviado via conta corporativa/pessoal, e os créditos serão recarregados automaticamente em sua conta APIYI.
- Publicação na documentação: O trabalho será publicado na seção de colaboradores da Central de Documentação da APIYI, com seu nome e informações de contato.
Canais de Contato Rápidos
- Site Oficial da APIYI: apiyi.com, rodapé, entrada "Programa de Desenvolvedores".
- WeChat de Atendimento ao Cliente: Siga a conta oficial da APIYI → menu "Contatar Suporte" → com a observação "Recompensa de Plugin".
- Envio por e-mail: Através do e-mail para desenvolvedores divulgado na Central de Documentação da APIYI (apiyi.com).
Esclarecendo equívocos comuns
Equívoco 1: "É preciso ser um programador profissional para participar"
Pelo contrário. O desenvolvimento de plugins no Coze baseia-se principalmente em configurações JSON e uma pequena quantidade de scripts, o que muitos desenvolvedores no-code conseguem fazer. O Declarative Node do N8N também não exige experiência profunda em TypeScript. Desde que você tenha criado algo funcional, você é bem-vindo para participar.
Equívoco 2: "É necessário que o trabalho esteja perfeito antes de enviar"
Errado. O nível de conclusão é iterativo, crescendo do menor para o maior. Você pode até enviar um plugin mínimo viável com "um modelo e uma função", desde que o código esteja limpo, funcional e traga valor ao usuário, você já garante a recompensa do nível padrão. O nível premium é um incentivo para contribuições mais sistemáticas, mas não é uma barreira de entrada.
Equívoco 3: "Plataformas pouco conhecidas não valem o esforço"
Muito pelo contrário. Os primeiros plugins que cobrirem plataformas escassas como Dify, FastGPT, LangFlow, entre outras, recebem pontos extras na avaliação, tornando mais fácil atingir o nível premium. Se você já tem experiência nessas plataformas, este programa de recompensas é uma ótima oportunidade para monetizar o que você já construiu.
Resumo
Este programa de recompensa para plugins de código aberto é, na essência, a nossa forma de "transformar em ferramentas e ecossistema" as capacidades do Modelo de Linguagem Grande da APIYI apiyi.com junto com a nossa comunidade. Queremos que cada desenvolvedor que cria bots no Coze, monta fluxos de trabalho no N8N ou se diverte com geração de imagens no ComfyUI possa usar com a maior facilidade os modelos mais avançados, como Nano Banana, Sora, SeeDance, GPT e Claude.
Se você já tem projetos prontos, esta recompensa é uma excelente oportunidade para monetizar seu código; se você tem ideias, mas ainda não começou, este também é o cenário ideal para iniciar um projeto open-source e construir sua marca técnica pessoal. Convidamos todos a enviarem suas contribuições para a APIYI apiyi.com e, claro, sintam-se à vontade para compartilhar este chamado com seus amigos que possam se interessar.
Vamos juntos transformar problemas que "os usuários vivem perguntando e o suporte vive respondendo" em ativos de código aberto compartilhados por toda a comunidade.
📌 Autoria: Este artigo foi publicado pela equipe de operações da APIYI apiyi.com, representando o lançamento oficial do Programa de Recompensas de Plugins de Código Aberto 2026 da comunidade APIYI. O canal de envio já está aberto e os critérios de premiação são válidos permanentemente. Fique ligado!
