ChatGPT Integration

Use 1FRX with ChatGPT Custom GPTs to generate social images, QR codes, and invoices directly in ChatGPT conversations. Enable ChatGPT to create branded visual assets on demand.

Setup

1. Create a Custom GPT

1. Log into ChatGPT and navigate to the Custom GPTs section
2. Click "Create a GPT"
3. Give your GPT a name like "1FRX Designer" or "Image Generator"
4. Add a description and system prompt
5. Proceed to the Actions section

2. Add 1FRX as an Action

1. In the Actions section, click "Create new action"
2. Select "Import from URL" and provide the OpenAPI 3.0 schema URL (see below)
3. Or paste the OpenAPI schema directly in the JSON editor
4. Add authentication: Select "API Key" and enter your 1FRX API key
5. Save the action and test with a sample prompt

OpenAPI 3.0 Schema

Use this schema to configure 1FRX in your Custom GPT:

openapi: 3.0.0
info:
  title: 1FRX API
  version: 1.0.0
servers:
  - url: https://api.1frx.com
paths:
  /og-image:
    post:
      summary: Generate OG image
      operationId: generateOGImage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
                subtitle:
                  type: string
                domain:
                  type: string
                template:
                  type: string
                  enum: [gradient, bold, minimal, modern]
                accentColor:
                  type: string
              required: [title, domain]
      responses:
        '200':
          description: Image generated
          content:
            application/json:
              schema:
                type: object
                properties:
                  url:
                    type: string
  /qr-code:
    post:
      summary: Generate QR code
      operationId: generateQRCode
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: string
                size:
                  type: integer
                errorCorrection:
                  type: string
              required: [data]
      responses:
        '200':
          description: QR code generated
  /invoice:
    post:
      summary: Generate invoice
      operationId: generateInvoice
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                invoiceNumber:
                  type: string
                amount:
                  type: number
                date:
                  type: string
                clientName:
                  type: string
              required: [invoiceNumber, amount]
      responses:
        '200':
          description: Invoice generated

Example Prompts to Try

Here are prompts you can use to test your 1FRX Custom GPT:

1. Social Media Image

"Create a social media image for my blog post titled 'The Future of AI' with the subtitle 'A guide to large language models' using the modern template and a blue accent color (#5ee3ff)."

2. QR Code for Event

"Generate a QR code that links to https://myevent.com/register. Make it extra large so it's scannable from a distance."

3. Invoice Generation

"Create an invoice for order #INV-2026-001 with a total of $2,500.00. The client is Acme Corporation. Use today's date."

4. Batch Image Generation

"I have 5 blog posts. Generate OG images for each with titles: 'Web3 Security', 'DeFi Basics', 'NFT Trends', 'Smart Contracts 101', and 'Crypto Wallets'. Use the gradient template."

5. Certificate Design

"Create a certificate for Jane Smith completing the 'Advanced Python' course on 2026-04-16. Make it look professional with a gradient background."

System Prompt Recommendation

Use this system prompt to guide your Custom GPT's behavior:

You are a creative design assistant powered by 1FRX. Your role is to help users generate professional social media images, QR codes, invoices, and certificates. 

When a user asks for an image or visual asset:
1. Ask clarifying questions about design preferences (colors, style, content)
2. Map their request to the appropriate 1FRX endpoint
3. Generate the asset and provide a link
4. Offer variations or improvements

Always be helpful and suggest design best practices. For colors, offer to use their brand colors if they provide them.

Privacy & Data Handling

Troubleshooting

Action not appearing in ChatGPT

Ensure your API key is correctly configured in the Custom GPT settings. Test the connection by running a simple prompt like "Generate a test QR code".

401 Unauthorized from 1FRX

Verify your 1FRX API key in the Custom GPT actions configuration. API keys are case-sensitive.

ChatGPT returns "Action failed"

Check that the OpenAPI schema is valid JSON and all required fields are mapped correctly. Try simplifying your prompt to test basic functionality.

Generated images not showing in ChatGPT

ChatGPT displays image URLs as links. Click the link to view the generated image in your browser. Ensure your 1FRX account has available API quota.

FAQ

Can I use this with ChatGPT Plus?

Yes. Custom GPTs are available to ChatGPT Plus subscribers. Standard ChatGPT users can use the 1FRX API directly through other integrations like Zapier or Make.

Is my content safe with 1FRX?

Your image parameters are processed by 1FRX but not stored permanently. Generated images are cached for performance but deleted after 30 days. Conversation data with ChatGPT is subject to OpenAI's privacy policy.

Can I share my Custom GPT publicly?

Yes, but ensure you don't expose your 1FRX API key in a way that's publicly readable. Custom GPT actions keep credentials private.

What endpoints are available?

All 1FRX endpoints (OG Image, QR Code, Invoice, Certificate, Event Ticket, YouTube Thumbnail, Speaker Promo) can be added as actions. Start with OG Image and QR Code for simplicity.