Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Fíordheimhniú, Eochracha API, agus Eagrú

Ceacht 3 as 22 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Fíordheimhniú, Eochracha API, agus Eagrú
  2. Cruthaigh do Chuntas agus Faigh Eochair
  3. Cén Cineál Eochrach le Roghnú
  4. Eagrúcháin agus Tionscadail
  5. Ná Nocht Do Chuid Eochracha Riamh
  6. Fíoraigh do Chumrúchán
  7. Príomhphointí

Fíordheimhniú, Eochracha API, agus Eagrú

Sula scríobhann tú aon líne cóid, caithfidh tú do rochtain API a chumrú. Clúdaíonn an ceacht seo cruthú eochracha, struchtúrú rochtana trí eagraíochtaí agus tionscadail, agus na réamhchúraimí slándála a choscann an tubaiste chlasaiceach: eochair a bhrú go hearráideach chuig stór poiblí áit a n-ídíonn strainséir í thar oíche.

Cruthaigh do Chuntas agus Faigh Eochair

Tógann an próiseas trí chéim. Ar dtús, téigh go platform.openai.com agus cruthaigh cuntas; gheobhaidh tú creidmheasanna saor in aisce go huathoibríoch chun turgnamh a dhéanamh. Ina dhiaidh sin, téigh go dtí an roinn API Keys ar an deasc rialaithe agus gineann eochair nua. Ní fheicfidh tú an eochair seo ach uair amháin: cóipeáil í láithreach, ach ná greamaigh í isteach i do chód.

# Your API key looks like this (never share it!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Best practice: use an environment variable
import os
api_key = os.environ.get("OPENAI_API_KEY")

Is é an tríú céim an athróg timpeallachta a dhearbhú, rud a bhraitheann ar do hardán. Ar mheaisín forbartha, is minic gurb é comhad .env a lódáiltear le python-dotenv an bealach is áisiúla. Ar fhreastalaí, is fearr athróg timpeallachta a shainíonn d’eagraitheoir nó do sheirbhís rúnda.

# Linux / macOS — add to ~/.bashrc or ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"

# .env file (with python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here

Cén Cineál Eochrach le Roghnú

Tá eochracha tionscadail, atá inaitheanta trína réimír sk-proj-, nasctha le tionscadal sonrach agus tairgeann siad an rialú is fearr. Úsáidfidh tú iad seo i ngach cás beagnach. Brathann an SDK orthu go huathoibríoch nuair a shocraítear an athróg timpeallachta, rud a fhágann go ndéanann OpenAI() samplú gan argóintí i ngach sampla sa chúrsa seo.

from openai import OpenAI

# The SDK automatically detects OPENAI_API_KEY
client = OpenAI()

# Or specify explicitly (not recommended for production)
client = OpenAI(api_key="sk-proj-...")

Is iad eochracha seirbhíse an dara cineál. Deartha d’fheidhmchláir fhreastalaí a éilíonn rochtain ardaithe, tugann siad ceadanna breise agus mar sin éilíonn siad cúram breise: stóráil iad i stór rúnda agus ná scaip a luach riamh chuig stáisiún oibre forbartha.

Eagrúcháin agus Tionscadail

Tá an rochtain struchtúrtha ar thrí leibhéal neadaithe:

  1. Eagraíocht: Do chuideachta nó do fhoireann
  2. Tionscadal: Grúpáil loighciúil (m.sh. “Chatbot Táirgeachta”, “Anailís Sonraí”)
  3. Eochair API: Nasctha le tionscadal sonrach

Má bhaineann tú le heagraíochtaí iolracha, sonraigh an ceann atá beartaithe agat a úsáid agus tú ag déanamh samplú den chliaint:

from openai import OpenAI

# Specify the organization (useful if you belong to multiple)
client = OpenAI(
    organization="org-xxxxxxxxxxxx",
    project="proj-xxxxxxxxxxxx"
)

Tóg an t-am chun do úsáid a roinnt ina tionscadail seachas gach rud a ródú trí eochair amháin. Feicfidh tú an tairbhe ag an gcéad chomhartha trioblóide. Tá a rianú úsáide féin ag gach tionscadal, rud a ligeann duit costais a chur i leith gné sonrach seachas iomlán míosúil doiléir. Tá teorainneacha ráta scartha freisin: ní chuirfidh post baisce oíche a sháithíonn a chuóta cosc ar do chatbot freagairt do chustaiméirí. Is féidir leat baill éagsúla a shannadh do gach tionscadal ansin, agus rud atá ríthábhachtach, eochair chompromáide a chúlghairm gan cur isteach ar fheidhmchláir eile.

Ná Nocht Do Chuid Eochracha Riamh

Tá an riail simplí agus absalóideach: ní fheictear eochair riamh i gcód foinse. Labhraíonn an chodarsnacht idir an dá blúire thíos níos airde ná léacht fhada.

# BAD — hardcoded key in code
client = OpenAI(api_key="sk-proj-abc123")  # DANGER!

# GOOD — environment variable
client = OpenAI()  # Automatically reads OPENAI_API_KEY

# GOOD — .env file with python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()

Baineann an toradh le do .gitignore, a chaithfidh comhaid chumraíochta áitiúla a eisiamh roimh do chéad ghealladh, ní ina dhiaidh. Fanann eochair a fhoilsítear agus a scriostar ina dhiaidh sin i stair an stórais.

# ALWAYS add these lines to your .gitignore
.env
.env.local
.env.production
*.key

Ar deireadh, pleanáil rothlú rialta, gach 90 lá. Is féidir leat é seo a dhéanamh gan am stad: cruthaigh eochair nua, nuashonraigh do imlonnúcháin, agus ansin scrios an sean-cheann ach amháin nuair nach bhfuil aon rud á húsáid aige a thuilleadh.

Fíoraigh do Chumrúchán

Sula dtéann tú ar aghaidh, rith an script seo. Seiceálann sí láithreacht na heochrach, taispeánann leagan giorraithe chun a dheimhniú gurb í an ceann ceart í, agus déanann glaonna fíor ansin. Athruit an tástáil seo gach uair a oibríonn timpeallacht go strange.

from openai import OpenAI
import os

def verify_configuration():
    """Verify that the API configuration is correct."""
    
    # Check for the key
    api_key = os.environ.get("OPENAI_API_KEY")
    if not api_key:
        print("ERROR: OPENAI_API_KEY not defined")
        return False
    
    print(f"Key detected: {api_key[:8]}...{api_key[-4:]}")
    
    # Test the connection
    try:
        client = OpenAI()
        response = client.responses.create(
            model="gpt-5.6-terra",
            input="Reply only: OK"
        )
        print(f"Connection successful: {response.output_text}")
        return True
    except Exception as e:
        print(f"Connection ERROR: {e}")
        return False

verify_configuration()
# Expected result:
# Key detected: sk-proj-...xxxx
# Connection successful: OK

Príomhphointí

  • Úsáid eochracha tionscadail (sk-proj-...) do gach feidhmchlár
  • Stóráil do chuid eochracha in athróga timpeallachta, riamh i gcód
  • Eagraigh do rochtain leis an hierarchaíocht Eagraíocht → Tionscadal → Eochair
  • Déan rothlú rialta ar do chuid eochracha (gach 90 lá)
  • Cuir .env le do .gitignore i gcónaí